Freigeben über


WebPartCollection.Item[] Eigenschaft

Definition

Gibt einen bestimmten Member der Auflistung entsprechend seiner Position oder einen eindeutigen Bezeichner zurück.

Überlädt

Item[Int32]

Gibt auf der Grundlage seiner Position in der Auflistung einen Member der Auflistung zurück.

Item[String]

Gibt auf der Grundlage eines eindeutigen Zeichenfolgenbezeichners einen Member der Auflistung zurück.

Item[Int32]

Gibt auf der Grundlage seiner Position in der Auflistung einen Member der Auflistung zurück.

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

Parameter

index
Int32

Der Index eines bestimmten WebPart-Steuerelements in einer Auflistung.

Eigenschaftswert

Eine WebPart am angegebenen Index in der Auflistung.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Item[] Indexers auf einer Webpartseite veranschaulicht. Dieses Beispiel umfasst drei Teile:

  • Der Code für die Seite in einer partiellen Klasse.

  • Die Webseite, die die Steuerelemente enthält.

  • Eine Beschreibung der Funktionsweise des Beispiels in einem Browser.

Der erste Teil des Codebeispiels enthält den Code für die Seite in einer partiellen Klasse. Beachten Sie, dass die Button2_Click Methode ein leeres WebPartCollection Objekt erstellt und ihr dann die WebPart Steuerelemente aus der WebPartZone1.WebParts -Eigenschaft zuweist. Die -Methode greift mithilfe des Indexes auf das erste Steuerelement in der Auflistung zu und schaltet den Title Eigenschaftswert um.

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

Der zweite Teil des Codebeispiels ist die Webseite, die die Steuerelemente enthält. Beachten Sie, dass es sich bei den in WebPartZone1 deklarierten Steuerelementen um Standardsteuerelemente ASP.NET Serversteuerelemente handelt. Da sie jedoch zur Laufzeit als GenericWebPart Steuerelemente umschlossen werden und die GenericWebPart Klasse von der WebPart -Klasse erbt, können die Steuerelemente zur Laufzeit als WebPart Steuerelemente behandelt und teil eines WebPartCollection Objekts werden.

<%@ 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>

Nachdem Sie die Seite in einem Browser geladen haben, klicken Sie auf die Schaltfläche Aufzählungszeichen1 Titel umschalten , und beachten Sie, dass der Code den Titel des Steuerelements zwischen den beiden verfügbaren Titeloptionen umschaltet.

Hinweise

Mit Item[] dem Indexer können Sie auf die zugrunde liegenden WebPart Steuerelemente in einem WebPartCollection Objekt nach Index zugreifen und deren Eigenschaftswerte oder Aufrufmethoden ändern.

Weitere Informationen

Gilt für:

Item[String]

Gibt auf der Grundlage eines eindeutigen Zeichenfolgenbezeichners einen Member der Auflistung zurück.

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

Parameter

id
String

Der eindeutige Bezeichner für ein bestimmtes WebPart-Steuerelement in einer Auflistung.

Eigenschaftswert

Die erste WebPart in der Auflistung, deren ID gleich dem Wert von id ist.

Hinweise

Mit dem Item[] Indexer können Sie auf ein WebPart Steuerelement in einem WebPartCollection Objekt gemäß einem eindeutigen Bezeichner zugreifen.

Hinweis

Der Webpart-Steuerelementsatz führt für diese Eigenschaft eine Abgleichung der Groß-/Kleinschreibung durch, sodass die Groß-/Kleinschreibung nicht teil eines eindeutigen id Werts ist.

Die Item[] -Eigenschaft identifiziert auch Elemente eines WebPartCollection Objekts in einigen speziellen Fällen. Bei Steuerelementen GenericWebPart kann der Indexer den Bezeichner für das zugrunde liegende untergeordnete Steuerelement abgleichen, das GenericWebPart vom Steuerelement umschlossen wird. Bei Steuerelementen ProxyWebPart vergleicht der Indexer den Bezeichner für das Steuerelement basierend auf einem Vergleich der id Groß-/Kleinschreibung und der OriginalID Eigenschaftswerte oder GenericWebPartID .

Weitere Informationen

Gilt für: