WebPartZoneCollection Constructores

Definición

Espacio de nombres:

System.Web.UI.WebControls.WebParts

Ensamblado:

System.Web.dll

Inicializa una nueva instancia de la clase WebPartZoneCollection.

Sobrecargas

WebPartZoneCollection()	Inicializa una instancia vacía de la clase WebPartZoneCollection.
WebPartZoneCollection(ICollection)	Inicializa una instancia de la clase WebPartZoneCollection pasando una colección de objetos WebPartZone.

Comentarios

El WebPartZoneCollection control utiliza el WebPartManager constructor, por otros controles del conjunto de controles de elementos web o por código de desarrollador personalizado, para crear una colección de solo lectura de los WebPartZone controles que existen en una página de elementos web.

WebPartZoneCollection()

Inicializa una instancia vacía de la clase WebPartZoneCollection.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Comentarios

El WebPartManager control usa este constructor dentro de su propio constructor para inicializar una nueva instancia de la WebPartZoneCollection clase para una página de elementos web.

Consulte también

• controles de elementos web de ASP.NET

WebPartZoneCollection(ICollection)

Inicializa una instancia de la clase WebPartZoneCollection pasando una colección 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

ICollection de objetos WebPartZone.

Excepciones

ArgumentNullException

La colección de zonas es null.

ArgumentException

Uno de los objetos de la colección es null o no es del tipo WebPartZone.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del WebPartZoneCollection constructor . El código completo del ejemplo se encuentra en la sección Ejemplo de la información general de la WebPartZoneCollection clase.

En la siguiente sección de código, observe que asigna un WebPartZoneCollection objeto a una variable recuperando el valor de la Zones propiedad . Si lo desea, en lugar de asignar todas las zonas de la Zones propiedad , puede crear una matriz de WebPartZoneBase objetos que contenga un subconjunto de todas las zonas de la página y asignar la matriz a un nuevo 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

Una vez creada la colección, puede recorrer en iteración fácilmente la colección y realizar operaciones en todas las zonas contenidas o su contenido. Para ejecutar el código de ejemplo, cargue la página en un explorador y haga clic en el botón Alternar modo de representación de verbo en cada zona. Esto alterna cómo se representan los verbos de la barra de título de cada control de servidor contenido en una zona. Los verbos pueden aparecer en un menú desplegable o directamente como vínculos en la barra de título.

Comentarios

Use el WebPartZoneCollection constructor cuando desee crear una colección personalizada de WebPartZone objetos para llevar a cabo operaciones mediante programación en ellos. Por ejemplo, podría tener acceso a la Zones propiedad y crear un subconjunto de objetos en una página de WebPartZone elementos web, asignarlos a un WebPartZoneCollection objeto y, a continuación, llevar a cabo operaciones en los controles secundarios o en varias propiedades de solo ese subconjunto de zonas.

Consulte también

• controles de elementos web de ASP.NET