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
| Nome | Description |
|---|---|
| WebPartZoneCollection() |
Inicializa uma instância vazia da WebPartZoneCollection classe. |
| WebPartZoneCollection(ICollection) |
Inicializa uma instância da WebPartZoneCollection classe passando uma coleção de WebPartZone objetos. |
Comentários
O WebPartZoneCollection construtor é usado pelo WebPartManager controle, por outros controles no conjunto de controle de Web Parts ou pelo código do 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 WebPartZoneCollection classe.
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 instância da WebPartZoneCollection classe passando uma coleção de WebPartZone objetos.
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 dos WebPartZone objetos.
Exceções
A coleção de zonas é null.
Um dos objetos da 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 é criada, você pode iterar facilmente por meio da 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 realizar 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 várias propriedades somente desse subconjunto de zonas.
