WebPartCollection.Item[] Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

WebPart

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

WebPart

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

ASP.NET Webpart-Steuerelemente

Gilt für:

Freigeben über

WebPartCollection.Item[] Eigenschaft

Definition

Überlädt

Item[Int32]

Parameter

Eigenschaftswert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Item[String]

Parameter

Eigenschaftswert

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen