WebPartCollection.Item[] Proprietà

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 della raccolta in base alla posizione o a un identificatore univoco.

Overload

Nome	Descrizione
Item[Int32]	Restituisce un membro dell'insieme in base alla relativa posizione nell'insieme.
Item[String]	Restituisce un membro della raccolta 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 particolare WebPart controllo in un insieme.

Valore della proprietà

WebPart

Oggetto WebPart in corrispondenza dell'indice specificato nell'insieme.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'indicizzatore Item[] in una pagina web part. In questo esempio sono presenti tre parti:

Codice per la pagina in una classe parziale.
Pagina Web contenente 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/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 della raccolta 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 per un particolare WebPart controllo in una raccolta.

Valore della proprietà

WebPart

Primo WebPart oggetto dell'insieme il cui ID è uguale 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.

Annotazioni

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 univoco id .

La Item[] proprietà funziona anche per identificare i membri di un WebPartCollection oggetto in alcuni casi specializzati. Nel caso dei controlli, l'indicizzatore è in grado di GenericWebPart 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

controlli web part ASP.NET

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

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

Commenti e suggerimenti