WebPartZoneCollection Construtores
Definição
Inicializa uma nova instância da classe WebPartZoneCollection.Initializes a new instance of the WebPartZoneCollection class.
Sobrecargas
| WebPartZoneCollection() |
Inicializa uma instância vazia da classe WebPartZoneCollection.Initializes an empty instance of the WebPartZoneCollection class. |
| WebPartZoneCollection(ICollection) |
Inicializa uma nova instância da classe WebPartZoneCollection passando uma coleção de objetos WebPartZone.Initializes an instance of the WebPartZoneCollection class by passing in a collection of WebPartZone objects. |
Comentários
O WebPartZoneCollection Construtor é usado pelo WebPartManager controle, por outros controles no conjunto de controle 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.The WebPartZoneCollection constructor is used by the WebPartManager control, by other controls in the Web Parts control set, or by custom developer code, to create a read-only collection of the WebPartZone controls that exist on a Web Parts page.
WebPartZoneCollection()
Inicializa uma instância vazia da classe WebPartZoneCollection.Initializes an empty instance of the WebPartZoneCollection class.
public:
WebPartZoneCollection();
public WebPartZoneCollection ();
Public Sub New ()
Comentários
O WebPartManager controle usa esse construtor em seu próprio construtor para inicializar uma nova instância da WebPartZoneCollection classe para uma página de Web Parts.The WebPartManager control uses this constructor within its own constructor to initialize a new instance of the WebPartZoneCollection class for a Web Parts page.
Aplica-se a
WebPartZoneCollection(ICollection)
Inicializa uma nova instância da classe WebPartZoneCollection passando uma coleção de objetos WebPartZone.Initializes an instance of the WebPartZoneCollection class by passing in a collection of WebPartZone objects.
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.An ICollection of WebPartZone objects.
Exceções
A coleção de zonas é null.The collection of zones is null.
Um dos objetos na coleção é null ou não é do tipo WebPartZone.One of the objects in the collection is null or is not of type WebPartZone.
Exemplos
O exemplo de código a seguir demonstra o uso do WebPartZoneCollection Construtor.The following code example demonstrates the use of the WebPartZoneCollection constructor. O código completo do exemplo é encontrado na seção de exemplo da WebPartZoneCollection classe visão geral.The complete code for the example is found in the Example section of the WebPartZoneCollection class overview.
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.In the following section of code, notice that it assigns a WebPartZoneCollection object to a variable by retrieving the value of the Zones property. Se desejar, em vez de atribuir todas as zonas da Zones propriedade, você poderá 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.If you wanted, rather than assigning all the zones from the Zones property, you could create an array of WebPartZoneBase objects containing a subset of all the zones on the page, and assign the array to a new WebPartZoneCollection object.
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 na coleção e executar operações em todas as zonas contidas ou seu conteúdo.After the collection is created, you can easily iterate through the collection and perform operations on all the contained zones or their contents. 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.To execute the example code, load the page in a browser, and click the Toggle Verb Render Mode button on each zone. Isso alterna como os verbos na barra de título de cada controle de servidor contido em uma zona são renderizados.This alternates how the verbs in the title bar of each server control contained in a zone are rendered. Os verbos podem aparecer em um menu suspenso ou diretamente como links na barra de título.The verbs can appear in a drop-down menu, or directly as links in the title bar.
Comentários
Use o WebPartZoneCollection Construtor quando desejar criar uma coleção personalizada de WebPartZone objetos para executar operações programáticas neles.Use the WebPartZoneCollection constructor when you want to create a custom collection of WebPartZone objects to carry out programmatic operations on them. Por exemplo, você pode acessar a Zones propriedade e criar um subconjunto de WebPartZone objetos em uma página Web Parts, atribuí-los a um WebPartZoneCollection objeto e executar operações nos controles filho ou várias propriedades somente desse subconjunto de zonas.For example, you could access the Zones property and create a subset of WebPartZone objects on a Web Parts page, assigning them to a WebPartZoneCollection object, and then carry out operations on the child controls or various properties of only that subset of zones.