WebPartZoneCollection Construtores

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Inicializa uma nova instância da WebPartZoneCollection classe.

Sobrecargas

Name Description
WebPartZoneCollection()

Inicializa uma instância vazia da WebPartZoneCollection classe.
WebPartZoneCollection(ICollection)

Inicializa uma instância da WebPartZoneCollection classe ao passar uma coleção de WebPartZone objetos.

Observações

O WebPartZoneCollection construtor é usado pelo WebPartManager controlo, por outros controlos no conjunto de controlos Web Parts, ou por código de desenvolvedor personalizado, para criar uma coleção de apenas leitura dos WebPartZone controlos que existem numa página de Web Parts.

WebPartZoneCollection()

Inicializa uma instância vazia da WebPartZoneCollection classe.

public:
 WebPartZoneCollection();
public WebPartZoneCollection();
Public Sub New ()

Observações

O WebPartManager controlo utiliza este construtor dentro do seu próprio construtor para inicializar uma nova instância da WebPartZoneCollection classe para uma página de Web Parts.

Ver também

Aplica-se a

WebPartZoneCollection(ICollection)

Inicializa uma instância da WebPartZoneCollection classe ao passar 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.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 da coleção é null ou não do tipo WebPartZone.

Exemplos

O exemplo de código seguinte demonstra a utilização do WebPartZoneCollection construtor. O código completo do exemplo encontra-se na secção Exemplo da WebPartZoneCollection visão geral da classe.

Na secção seguinte do código, repare que atribui um WebPartZoneCollection objeto a uma variável ao recuperar o valor da Zones propriedade. Se quiseres, em vez de atribuires todas as zonas da Zones propriedade, poderias criar um array de WebPartZoneBase objetos contendo um subconjunto de todas as zonas na página e atribuir o array 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 de criada a coleção, pode facilmente iterar pela coleção e realizar operações em todas as zonas contidas ou no seu conteúdo. Para executar o código de exemplo, carregue a página num navegador e clique no botão Toggle Verb Render Mode em cada zona. Isto alterna a forma como os verbos na barra de título de cada controlo de servidor contidos numa zona são renderizados. Os verbos podem aparecer num menu suspenso ou diretamente como links na barra de título.

Observações

Usa o WebPartZoneCollection construtor quando quiseres criar uma coleção personalizada de WebPartZone objetos para realizar operações programáticas sobre eles. Por exemplo, poderia aceder à Zones propriedade e criar um subconjunto de WebPartZone objetos numa página de Web Parts, atribuindo-os a um WebPartZoneCollection objeto, e depois realizar operações nos controlos filhos ou em várias propriedades apenas desse subconjunto de zonas.

Ver também

Aplica-se a