WebPartCollection.Item[] Właściwość

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca określony element członkowski kolekcji zgodnie z jego pozycją lub unikatowym identyfikatorem.

Przeciążenia

Nazwa	Opis
Item[Int32]	Zwraca element członkowski kolekcji na podstawie jego pozycji w kolekcji.
Item[String]	Zwraca element członkowski kolekcji na podstawie unikatowego identyfikatora ciągu.

Item[Int32]

Zwraca element członkowski kolekcji na podstawie jego pozycji w kolekcji.

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

Parametry

index: Int32

Indeks określonej WebPart kontrolki w kolekcji.

Wartość właściwości

WebPart

Wartość WebPart w określonym indeksie w kolekcji.

Przykłady

Poniższy przykład kodu przedstawia użycie indeksatora Item[] na stronie składników Web Part. Ten przykład zawiera trzy części:

Kod strony w klasie częściowej.
Strona sieci Web zawierająca kontrolki.
Opis działania przykładu w przeglądarce.

Pierwsza część przykładu kodu zawiera kod strony w klasie częściowej. Należy pamiętać, że Button2_Click metoda tworzy pusty WebPartCollection obiekt, a następnie przypisuje do niego kontrolki WebPart z WebPartZone1.WebParts właściwości . Metoda uzyskuje dostęp do pierwszej kontrolki w kolekcji przy użyciu jej indeksu i przełącza Title wartość właściwości.

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

Drugą częścią przykładu kodu jest strona sieci Web zawierająca kontrolki. Zwróć uwagę, że zadeklarowane WebPartZone1 kontrolki są standardowymi kontrolkami serwera ASP.NET, ale ponieważ są one opakowane jako GenericWebPart kontrolki w czasie wykonywania, a GenericWebPart klasa dziedziczy z WebPart klasy, kontrolki mogą być traktowane jako WebPart kontrolki w czasie wykonywania i wykonane jako część WebPartCollection obiektu.

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

Po załadowaniu strony w przeglądarce kliknij przycisk Przełącz tytuł bulletedList1 i zwróć uwagę, że kod przełącza tytuł kontrolki między dwoma dostępnymi opcjami tytułu.

Uwagi

Indeksator Item[] umożliwia dostęp do podstawowych WebPart kontrolek w obiekcie według indeksu WebPartCollection i zmiany ich wartości właściwości lub metod wywołania.

Zobacz też

Dotyczy

Item[String]

Zwraca element członkowski kolekcji na podstawie unikatowego identyfikatora ciągu.

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

Parametry

id: String

Unikatowy identyfikator określonej WebPart kontrolki w kolekcji.

Wartość właściwości

WebPart

WebPart Pierwszy w kolekcji, którego identyfikator jest równy wartości id.

Uwagi

Indeksator Item[] umożliwia dostęp do WebPart kontrolki w WebPartCollection obiekcie zgodnie z unikatowym identyfikatorem.

Uwaga / Notatka

Zestaw kontrolek składników Web Part wykonuje dopasowanie bez uwzględniania wielkości liter dla tej właściwości, więc wielkość liter nie jest częścią unikatowej id wartości.

Właściwość Item[] działa również w celu zidentyfikowania WebPartCollection elementów członkowskich obiektu w niektórych wyspecjalizowanych przypadkach. W przypadku GenericWebPart kontrolek indeksator jest w stanie dopasować identyfikator podstawowej kontrolki podrzędnej opakowanej przez kontrolkę GenericWebPart . W przypadku ProxyWebPart kontrolek indeksator pasuje do identyfikatora kontrolki w oparciu o porównanie wielkości liter parametru id i OriginalID wartości właściwości lub GenericWebPartID .

Zobacz też

kontrolki składników Web Part ASP.NET

Dotyczy

Opinia

Czy ta strona była pomocna?

Udostępnij za pośrednictwem

WebPartCollection.Item[] Właściwość

Definicja

Przeciążenia

Item[Int32]

Parametry

Wartość właściwości

Przykłady

Uwagi

Zobacz też

Dotyczy

Item[String]

Parametry

Wartość właściwości

Uwagi

Zobacz też

Dotyczy

Opinia