WebPartZoneCollection Constructeurs

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Initialise une nouvelle instance de la classe WebPartZoneCollection.

Surcharges

Nom Description
WebPartZoneCollection()

Initialise une instance vide de la WebPartZoneCollection classe.
WebPartZoneCollection(ICollection)

Initialise une instance de la WebPartZoneCollection classe en passant une collection d’objets WebPartZone .

Remarques

Le WebPartZoneCollection constructeur est utilisé par le WebPartManager contrôle, par d’autres contrôles dans le jeu de contrôles WebPart ou par du code de développeur personnalisé, pour créer une collection en lecture seule des WebPartZone contrôles qui existent sur une page de composants WebPart.

WebPartZoneCollection()

Initialise une instance vide de la WebPartZoneCollection classe.

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

Remarques

Le WebPartManager contrôle utilise ce constructeur dans son propre constructeur pour initialiser une nouvelle instance de la WebPartZoneCollection classe pour une page de composants WebPart.

Voir aussi

S’applique à

WebPartZoneCollection(ICollection)

Initialise une instance de la WebPartZoneCollection classe en passant une collection d’objets 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)

Paramètres

webPartZones
ICollection

Un ICollection objet WebPartZone .

Exceptions

ArgumentNullException

La collection de zones est null.

ArgumentException

L’un des objets de la collection est ou n’est null pas de type WebPartZone.

Exemples

L’exemple de code suivant illustre l’utilisation du WebPartZoneCollection constructeur. Le code complet de l’exemple se trouve dans la section Exemple de vue d’ensemble de la WebPartZoneCollection classe.

Dans la section suivante du code, notez qu’il affecte un WebPartZoneCollection objet à une variable en récupérant la valeur de la Zones propriété. Si vous le souhaitez, plutôt que d’affecter toutes les zones de la Zones propriété, vous pouvez créer un tableau d’objets WebPartZoneBase contenant un sous-ensemble de toutes les zones de la page et affecter le tableau à un nouvel WebPartZoneCollection objet.

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

Une fois la collection créée, vous pouvez facilement itérer dans la collection et effectuer des opérations sur toutes les zones contenues ou leur contenu. Pour exécuter l’exemple de code, chargez la page dans un navigateur, puis cliquez sur le bouton Basculer le mode de rendu du verbe sur chaque zone. Cela alterne le rendu des verbes dans la barre de titre de chaque contrôle serveur contenu dans une zone. Les verbes peuvent apparaître dans un menu déroulant ou directement sous forme de liens dans la barre de titre.

Remarques

Utilisez le WebPartZoneCollection constructeur lorsque vous souhaitez créer une collection personnalisée d’objets WebPartZone pour effectuer des opérations programmatiques sur ces objets. Par exemple, vous pouvez accéder à la Zones propriété et créer un sous-ensemble d’objets WebPartZone sur une page de composants WebPart, les affecter à un WebPartZoneCollection objet, puis effectuer des opérations sur les contrôles enfants ou différentes propriétés de ce sous-ensemble de zones uniquement.

Voir aussi

S’applique à