WebPartCollection.Item[] Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Returnerar en specifik medlem i samlingen enligt dess position eller en unik identifierare.

Överlagringar

Name Description
Item[Int32]

Returnerar en medlem i samlingen baserat på dess position i samlingen.
Item[String]

Returnerar en medlem i samlingen baserat på en unik strängidentifierare.

Item[Int32]

Returnerar en medlem i samlingen baserat på dess position i samlingen.

public:
 property System::Web::UI::WebControls::WebParts::WebPart ^ default[int] { System::Web::UI::WebControls::WebParts::WebPart ^ get(int index); };
public System.Web.UI.WebControls.WebParts.WebPart this[int index] { get; }
member this.Item(int) : System.Web.UI.WebControls.WebParts.WebPart
Default Public ReadOnly Property Item(index As Integer) As WebPart

Parametrar

index
Int32

Indexet för en viss WebPart kontroll i en samling.

Egenskapsvärde

WebPart

A WebPart vid det angivna indexet i samlingen.

Exempel

I följande kodexempel visas hur indexeraren används Item[] på en webbdelssida. Det här exemplet har tre delar:

  • Koden för sidan i en partiell klass.

  • Webbsidan som innehåller kontrollerna.

  • En beskrivning av hur exemplet fungerar i en webbläsare.

Den första delen av kodexemplet innehåller koden för sidan i en partiell klass. Observera att Button2_Click metoden skapar ett tomt WebPartCollection objekt och sedan tilldelar kontrollerna från WebPart egenskapen till detWebPartZone1.WebParts. Metoden kommer åt den första kontrollen i samlingen med hjälp av dess index och växlar dess Title egenskapsvärde.

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class webpartcollectioncs : System.Web.UI.Page
{
  protected void Button1_Click(object sender, EventArgs e)
  {

    WebPartCollection partCollection = mgr1.WebParts;

    foreach (WebPart part in partCollection)
    {
      if (part.ChromeState != PartChromeState.Minimized)
        part.ChromeState = PartChromeState.Minimized;
      else
        part.ChromeState = PartChromeState.Normal;
    }
  }
  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartCollection partCollection = WebPartZone1.WebParts;

    if (partCollection[0].Title == "My Link List")
      partCollection[0].Title = "Favorite Links";
    else
      partCollection[0].Title = "My Link List";
  }
}

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Partial Public Class webpartcollectionvb

  Inherits System.Web.UI.Page

  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim partCollection As WebPartCollection = mgr1.WebParts
    Dim part As WebPart

    For Each part In partCollection
      If part.ChromeState <> PartChromeState.Minimized Then
        part.ChromeState = PartChromeState.Minimized
      Else
        part.ChromeState = PartChromeState.Normal
      End If
    Next

  End Sub

  Protected Sub Button2_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim partCollection As WebPartCollection = WebPartZone1.WebParts

    If partCollection(0).Title = "My Link List" Then
      partCollection(0).Title = "Favorite Links"
    Else
      partCollection(0).Title = "My Link List"
    End If

  End Sub

End Class

Den andra delen av kodexemplet är webbsidan som innehåller kontrollerna. Observera att de kontroller som deklareras i WebPartZone1 är standard ASP.NET serverkontroller. men eftersom de omsluts som GenericWebPart kontroller vid körning, och klassen GenericWebPart ärver från klassen WebPart, kan kontrollerna behandlas som WebPart kontroller vid körning och göras till en del av ett WebPartCollection objekt.

<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

<%@ Page Language="vb"
  Codefile="webpartcollection.vb" 
  Inherits="webpartcollectionvb" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

När du har läst in sidan i en webbläsare klickar du på knappen Växla punktlista1 rubrik och ser att koden växlar kontrollens rubrik mellan de två tillgängliga rubrikalternativen.

Kommentarer

Med Item[] indexeraren kan du komma åt de underliggande WebPart kontrollerna i ett WebPartCollection objekt efter index och ändra deras egenskapsvärden eller anropsmetoder.

Se även

Gäller för

Item[String]

Returnerar en medlem i samlingen baserat på en unik strängidentifierare.

public:
 property System::Web::UI::WebControls::WebParts::WebPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::WebPart ^ get(System::String ^ id); };
public System.Web.UI.WebControls.WebParts.WebPart this[string id] { get; }
member this.Item(string) : System.Web.UI.WebControls.WebParts.WebPart
Default Public ReadOnly Property Item(id As String) As WebPart

Parametrar

id
String

Den unika identifieraren för en viss WebPart kontroll i en samling.

Egenskapsvärde

WebPart

Den första WebPart i samlingen vars ID är lika med värdet för id.

Kommentarer

Med Item[] indexeraren kan du komma åt en WebPart kontroll i ett WebPartCollection objekt enligt en unik identifierare.

Note

Kontrolluppsättningen Webbdelar utför skiftlägesokänslig matchning på den här egenskapen, så skiftlägeskänslighet är inte en del av ett unikt id värde.

Egenskapen Item[] fungerar också för att identifiera medlemmar i ett WebPartCollection objekt i vissa specialiserade fall. När det gäller GenericWebPart kontroller kan indexeraren matcha identifieraren för den underliggande underordnade kontrollen som omsluts av GenericWebPart kontrollen. När det gäller ProxyWebPart kontroller matchar indexeraren identifieraren för kontrollen baserat på en skiftlägeskänslig jämförelse av parametern id och antingen egenskapsvärdena OriginalID eller GenericWebPartID .

Se även

Gäller för