CatalogZoneBase.CatalogParts Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém uma coleção de todos os controles de CatalogPart contidos em uma zona de CatalogZoneBase.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ CatalogParts { System::Web::UI::WebControls::WebParts::CatalogPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.CatalogPartCollection CatalogParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.CatalogParts : System.Web.UI.WebControls.WebParts.CatalogPartCollection

Public ReadOnly Property CatalogParts As CatalogPartCollection

Valor da propriedade

CatalogPartCollection

Um CatalogPartCollection que contém todos os controles individuais CatalogPart em uma zona.

Atributos

BrowsableAttribute

Exceções

InvalidOperationException

Um CatalogPart que está sendo adicionado à coleção não tinha um valor atribuído à sua propriedade de ID.

Exemplos

O exemplo de código a seguir demonstra como acessar a CatalogParts propriedade programaticamente. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo da visão geral da CatalogZoneBase classe.

O exemplo de código mostra como acessar a CatalogParts propriedade, iterar pela coleção e listar as IDs de todos os CatalogPart controles na zona.

protected void Button2_Click(object sender, EventArgs e)
{
  Label1.Text = "<h3>CatalogPart List</h3>";
  foreach(CatalogPart part in CatalogZone1.CatalogParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Protected Sub Button2_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  Label1.Text = "<h3>CatalogPart List</h3>"
  Dim part As CatalogPart
  For Each part In CatalogZone1.CatalogParts
    Label1.Text += part.ID + "<br />"
  Next part

End Sub

Ao carregar a página em um navegador, você pode selecionar Catálogo na lista suspensa para alternar para o modo de exibição do catálogo. Quando o catálogo estiver visível, você poderá clicar no botão Listar CatalogParts para demonstrar como a CatalogParts propriedade pode ser acessada.

Comentários

A CatalogParts propriedade fornece uma referência a uma coleção de todos os CatalogPart controles na zona. Ele faz referência aos CatalogPart controles fornecidos com o conjunto de controles de Web Parts e a todos os controles personalizados CatalogPart adicionados à zona.

A coleção é criada inicialmente quando outro método acessa a CatalogParts propriedade e a propriedade chama o CreateCatalogParts método .

Observação

Observe que qualquer CatalogPart um que seja adicionado à coleção de CatalogPart controles em uma implementação do CreateCatalogParts método deve ter um valor atribuído à sua propriedade ID, caso contrário, uma exceção será gerada quando a coleção for atribuída à CatalogParts propriedade .

Confira também

• CatalogPartCollection
• Controles de Web Parts do ASP.NET