WebPartCollection.Item[] Proprietà

Definizione

Restituisce un membro specifico dell'insieme a seconda della relativa posizione o di un identificatore univoco.

Overload

Item[Int32]

Restituisce un membro dell'insieme in base alla relativa posizione nell'insieme.

Item[String]

Restituisce un membro dell'insieme in base a un identificatore di stringa univoco.

Item[Int32]

Restituisce un membro dell'insieme in base alla relativa posizione nell'insieme.

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

Parametri

index
Int32

Indice di un controllo WebPart specifico in un insieme.

Valore della proprietà

Oggetto WebPart nell'indice specificato nell'insieme.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'indicizzatore Item[] in una pagina Web part. Questo esempio include tre parti:

  • Codice per la pagina in una classe parziale.

  • Pagina Web che contiene i controlli.

  • Descrizione del funzionamento dell'esempio in un browser.

La prima parte dell'esempio di codice contiene il codice per la pagina in una classe parziale. Si noti che il Button2_Click metodo crea un oggetto vuoto WebPartCollection , quindi lo assegna ai WebPart controlli della WebPartZone1.WebParts proprietà . Il metodo accede al primo controllo dell'insieme usando il relativo indice e ne attiva o disattiva il Title valore della proprietà.

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

La seconda parte dell'esempio di codice è la pagina Web che contiene i controlli. Si noti che i controlli dichiarati in WebPartZone1 sono controlli standard ASP.NET server, ma poiché vengono sottoposti a wrapping come GenericWebPart controlli in fase di esecuzione e la GenericWebPart classe eredita dalla WebPart classe , i controlli possono essere considerati controlli WebPart in fase di esecuzione e fanno parte di un WebPartCollection oggetto .

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

Dopo aver caricato la pagina in un browser, fare clic sul pulsante Toggle BulletedList1 Title (Titolo bulletedList1 ) e notare che il codice attiva o disattiva il titolo del controllo tra le due opzioni del titolo disponibili.

Commenti

L'indicizzatore Item[] consente di accedere ai controlli sottostanti WebPart in un WebPartCollection oggetto per indice e di modificare i valori delle proprietà o i metodi di chiamata.

Vedi anche

Si applica a

Item[String]

Restituisce un membro dell'insieme in base a un identificatore di stringa univoco.

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

Parametri

id
String

Identificatore univoco di un controllo WebPart specifico in una raccolta.

Valore della proprietà

Primo oggetto WebPart nell'insieme il cui ID corrisponde al valore di id.

Commenti

L'indicizzatore Item[] consente di accedere a un WebPart controllo in un WebPartCollection oggetto in base a un identificatore univoco.

Nota

Il set di controlli Web part esegue la corrispondenza senza distinzione tra maiuscole e minuscole in questa proprietà, pertanto la distinzione tra maiuscole e minuscole non fa parte di un valore univoco id .

La Item[] proprietà funziona anche per identificare i membri di un WebPartCollection oggetto in alcuni casi specializzati. Nel caso dei GenericWebPart controlli, l'indicizzatore è in grado di corrispondere all'identificatore per il controllo figlio sottostante di cui è stato eseguito il wrapping dal GenericWebPart controllo . Nel caso dei ProxyWebPart controlli, l'indicizzatore corrisponde all'identificatore per il controllo in base a un confronto senza distinzione tra maiuscole e minuscole del id parametro e dei valori della OriginalID proprietà o GenericWebPartID .

Vedi anche

Si applica a