WebPartCollection.Item[] Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls.WebParts

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí konkrétního člena kolekce podle jeho pozice nebo jedinečného identifikátoru.

Přetížení

Item[Int32]	Vrátí člena kolekce na základě jeho pozice v kolekci.
Item[String]	Vrátí člen kolekce na základě jedinečného identifikátoru řetězce.

Item[Int32]

Vrátí člena kolekce na základě jeho pozice v kolekci.

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

Index určitého WebPart ovládacího prvku v kolekci.

Hodnota vlastnosti

WebPart

A WebPart v zadaném indexu v kolekci.

Příklady

Následující příklad kódu ukazuje použití indexeru Item[] na stránce webových částí. Tento příklad má tři části:

Kód stránky v částečné třídě.
Webová stránka, která obsahuje ovládací prvky.
Popis fungování příkladu v prohlížeči

První část příkladu kódu obsahuje kód pro stránku v částečné třídě. Všimněte si Button2_Click , že metoda vytvoří prázdný WebPartCollection objekt a pak mu WebPart přiřadí ovládací prvky z WebPartZone1.WebParts vlastnosti . Metoda přistupuje k prvnímu ovládacímu prvku v kolekci pomocí jeho indexu a přepíná hodnotu jeho Title vlastnosti.

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

Druhou částí příkladu kódu je webová stránka, která obsahuje ovládací prvky. Všimněte si, že ovládací prvky deklarované v WebPartZone1 jsou standardní ASP.NET serverové ovládací prvky, ale protože jsou zabaleny jako GenericWebPart ovládací prvky v době běhu a GenericWebPart třída dědí z WebPart třídy, lze ovládací prvky považovat za WebPart ovládací prvky za běhu a jsou součástí objektu WebPartCollection .

<%@ 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 načtení stránky v prohlížeči klikněte na tlačítko Toggle BulletedList1 Title (Přepnout název odrážkového seznamu1) a všimněte si, že kód přepíná název ovládacího prvku mezi dvěma dostupnými volbami názvu.

Poznámky

Indexer Item[] umožňuje přístup k podkladovým WebPart ovládacím prvkům v objektu podle indexu WebPartCollection a měnit jejich hodnoty vlastností nebo metody volání.

Viz také

Platí pro

Item[String]

Vrátí člen kolekce na základě jedinečného identifikátoru řetězce.

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

Jedinečný identifikátor určitého WebPart ovládacího prvku v kolekci.

Hodnota vlastnosti

WebPart

První WebPart v kolekci, jehož ID se rovná hodnotě id.

Poznámky

Indexer Item[] umožňuje přístup k ovládacímu WebPart prvku v objektu WebPartCollection podle jedinečného identifikátoru.

Poznámka

Sada webových částí provádí porovnávání s touto vlastností bez rozlišování malých a velkých písmen, takže rozlišování malých a malých písmen není součástí jedinečné id hodnoty.

Vlastnost Item[] také funguje k identifikaci členů objektu WebPartCollection v některých specializovaných případech. V případě ovládacích GenericWebPart prvků může indexer odpovídat identifikátoru podkladového podřízeného ovládacího prvku zabaleného ovládacím GenericWebPart prvek. V případě ovládacích ProxyWebPart prvků indexer porovnává identifikátor ovládacího prvku na základě porovnání parametru id a hodnot vlastností nebo GenericWebPartID , které nerozlišují malá a OriginalID velká písmena.

Viz také

ASP.NET ovládací prvky webových částí

Platí pro

Sdílet prostřednictvím

WebPartCollection.Item[] Vlastnost

Definice

Přetížení

Item[Int32]

Parametry

Hodnota vlastnosti

Příklady

Poznámky

Viz také

Platí pro

Item[String]

Parametry

Hodnota vlastnosti

Poznámky

Viz také

Platí pro

Další materiály