WebPartCollection.Item[] Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à

WebPart

Oggetto WebPart nell'indice specificato nell'insieme.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'indicizzatore Item[] in una pagina di 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à

WebPart

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 su questa proprietà, pertanto la distinzione tra maiuscole e minuscole non fa parte di un valore univocoid.

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 trovare la corrispondenza con l'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

controlli ASP.NET Web part

Si applica a

WebPartCollection.Item[] Proprietà

Definizione

Overload

Item[Int32]

Parametri

Valore della proprietà

Esempio

Commenti

Vedi anche

Si applica a

Item[String]

Parametri

Valore della proprietà

Commenti

Vedi anche

Si applica a

Risorse aggiuntive