CatalogZoneBase.CatalogParts Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um CatalogPartCollection que contém todos os controles individuais CatalogPart em uma zona.
- Atributos
Exceções
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 .