Partilhar via


WebPartCollection.Item[] Propriedade

Definição

Retorna um membro específico da coleção de acordo com sua posição ou com um identificador exclusivo.

Sobrecargas

Item[Int32]

Retorna um membro da coleção com base em sua posição na coleção.

Item[String]

Retorna um membro da coleção com base em um identificador de cadeia de caracteres exclusivo.

Item[Int32]

Retorna um membro da coleção com base em sua posição na coleção.

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

Parâmetros

index
Int32

O índice de um determinado controle WebPart em uma coleção.

Valor da propriedade

Um WebPart no índice especificado na coleção.

Exemplos

O exemplo de código a seguir demonstra o uso do Item[] indexador em uma página de Web Parts. Este exemplo tem três partes:

  • O código da página em uma classe parcial.

  • A página da Web que contém os controles.

  • Uma descrição de como o exemplo funciona em um navegador.

A primeira parte do exemplo de código contém o código da página em uma classe parcial. Observe que o Button2_Click método cria um objeto vazio WebPartCollection e atribui a ele os WebPart controles da WebPartZone1.WebParts propriedade . O método acessa o primeiro controle na coleção usando seu índice e alterna seu Title valor de propriedade.

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

A segunda parte do exemplo de código é a página da Web que contém os controles. Observe que os controles declarados em WebPartZone1 são controles de servidor padrão ASP.NET, mas como são encapsulados como GenericWebPart controles em tempo de execução e a GenericWebPart classe herda da WebPart classe , os controles podem ser tratados como WebPart controles em tempo de execução e fazem parte de um WebPartCollection objeto.

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

Depois de carregar a página em um navegador, clique no botão Alternar BulletedList1 Title e observe que o código alterna o título do controle entre as duas opções de título disponíveis.

Comentários

O Item[] indexador permite que você acesse os controles subjacentes WebPart em um WebPartCollection objeto por índice e altere seus valores de propriedade ou métodos de chamada.

Confira também

Aplica-se a

Item[String]

Retorna um membro da coleção com base em um identificador de cadeia de caracteres exclusivo.

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

Parâmetros

id
String

O identificador exclusivo para um controle WebPart específico em uma coleção.

Valor da propriedade

O primeiro WebPart na coleção cuja ID é igual ao valor de id.

Comentários

O Item[] indexador permite que você acesse um WebPart controle em um WebPartCollection objeto de acordo com um identificador exclusivo.

Observação

O conjunto de controle de Web Parts executa correspondências que não diferenciam maiúsculas de minúsculas nessa propriedade, portanto, a confidencialidade de maiúsculas e minúsculas não faz parte de um valor exclusivo id .

A Item[] propriedade também funciona para identificar membros de um WebPartCollection objeto em alguns casos especializados. No caso de GenericWebPart controles, o indexador é capaz de corresponder ao identificador para o controle filho subjacente encapsulado pelo GenericWebPart controle . No caso de ProxyWebPart controles, o indexador corresponde ao identificador do controle com base em uma comparação que não diferencia maiúsculas de minúsculas do id parâmetro e dos valores de OriginalID propriedade ou GenericWebPartID .

Confira também

Aplica-se a