WebPartZoneCollection Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase WebPartZoneCollection.
Sobrecargas
| Nombre | Description |
|---|---|
| WebPartZoneCollection() |
Inicializa una instancia vacía de la WebPartZoneCollection clase . |
| WebPartZoneCollection(ICollection) |
Inicializa una instancia de la WebPartZoneCollection clase pasando una colección de WebPartZone objetos . |
Comentarios
El WebPartZoneCollection control usa 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 WebPartZoneCollection clase .
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
Se aplica a
WebPartZoneCollection(ICollection)
Inicializa una instancia de la WebPartZoneCollection clase pasando una colección 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
de ICollectionWebPartZone objetos .
Excepciones
La colección de zonas es null.
Uno de los objetos de la colección es null o no es de 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 en 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 verbos 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, realizar operaciones en los controles secundarios o varias propiedades de solo ese subconjunto de zonas.
