WebPartZoneCollection Construtores

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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

• Controles de Web Parts do ASP.NET

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.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

Parâmetros

webPartZones

ICollection

Um ICollection de WebPartZone objetos.

Exceções

ArgumentNullException

A coleção de zonas é null.

ArgumentException

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.

Confira também

• Controles de Web Parts do ASP.NET