WebPartZoneCollection Construtores
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.
Inicializa uma nova instância da classe WebPartZoneCollection.
Sobrecargas
| WebPartZoneCollection() |
Inicializa uma instância vazia da classe WebPartZoneCollection. |
| WebPartZoneCollection(ICollection) |
Inicializa uma nova instância da classe WebPartZoneCollection passando uma coleção de objetos WebPartZone. |
Comentários
O WebPartZoneCollection construtor é usado pelo WebPartManager controle , por outros controles no conjunto de controles de Web Parts, ou por código de desenvolvedor personalizado, para criar uma coleção somente leitura dos WebPartZone controles que existem em uma página de Web Parts.
WebPartZoneCollection()
Inicializa uma instância vazia da classe WebPartZoneCollection.
public:
WebPartZoneCollection();public WebPartZoneCollection ();Public Sub New ()Comentários
O WebPartManager controle usa esse construtor dentro de seu próprio construtor para inicializar uma nova instância da WebPartZoneCollection classe para uma página de Web Parts.
Confira também
Aplica-se a
WebPartZoneCollection(ICollection)
Inicializa uma nova instância da classe WebPartZoneCollection passando uma coleção de objetos WebPartZone.
public:
WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);public WebPartZoneCollection (System.Collections.ICollection webPartZones);new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollectionPublic Sub New (webPartZones As ICollection)Parâmetros
- webPartZones
- ICollection
Um ICollection de WebPartZone objetos.
Exceções
A coleção de zonas é null.
Um dos objetos na coleção é null ou não é do tipo WebPartZone.
Exemplos
O exemplo de código a seguir demonstra o uso do WebPartZoneCollection construtor . O código completo do exemplo é encontrado na seção Exemplo da visão geral da WebPartZoneCollection classe.
Na seção de código a seguir, observe que ele atribui um WebPartZoneCollection objeto a uma variável recuperando o valor da Zones propriedade . Se você quisesse, em vez de atribuir todas as zonas da Zones propriedade , poderia criar uma matriz de WebPartZoneBase objetos contendo um subconjunto de todas as zonas na página e atribuir a matriz a um novo WebPartZoneCollection objeto.
protected void Button5_Click(object sender, EventArgs e)
{
Label1.Text = String.Empty;
WebPartZoneCollection zoneCollection = mgr.Zones;
foreach (WebPartZone zone in zoneCollection)
{
if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
else
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
}
}
Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = String.Empty
Dim zoneCollection As WebPartZoneCollection = mgr.Zones
Dim zone As WebPartZone
For Each zone In zoneCollection
If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
Else
zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
End If
Next zone
End Sub
Depois que a coleção for criada, você poderá iterar facilmente pela coleção e executar operações em todas as zonas contidas ou em seu conteúdo. Para executar o código de exemplo, carregue a página em um navegador e clique no botão Alternar Modo de Renderização de Verbo em cada zona. Isso alterna como os verbos na barra de título de cada controle de servidor contido em uma zona são renderizados. Os verbos podem aparecer em um menu suspenso ou diretamente como links na barra de título.
Comentários
Use o WebPartZoneCollection construtor quando quiser criar uma coleção personalizada de WebPartZone objetos para executar operações programáticas neles. Por exemplo, você pode acessar a Zones propriedade e criar um subconjunto de WebPartZone objetos em uma página de Web Parts, atribuindo-os a um WebPartZoneCollection objeto e, em seguida, realizar operações nos controles filho ou em várias propriedades somente desse subconjunto de zonas.
