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

WebPartZoneCollection()	Initialise une instance vide de la classe WebPartZoneCollection.
WebPartZoneCollection(ICollection)	Initialise une instance de la classe WebPartZoneCollection en passant dans une collection d'objets WebPartZone.

Remarques

Le WebPartZoneCollection constructeur est utilisé par le WebPartManager contrôle, par d’autres contrôles dans l’ensemble 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 classe WebPartZoneCollection.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Remarques

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

Voir aussi

• contrôles de composants WebPart ASP.NET

WebPartZoneCollection(ICollection)

Initialise une instance de la classe WebPartZoneCollection en passant dans 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

ICollection d'objets WebPartZone.

Exceptions

ArgumentNullException

La collection de zones a la valeur null.

ArgumentException

L'un des objets de la collection est null ou n'est 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 la vue d’ensemble de la WebPartZoneCollection classe.

Dans la section de code suivante, notez qu’il affecte un WebPartZoneCollection objet à une variable en récupérant la valeur de la Zones propriété . Si vous le souhaitez, au lieu 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 Désactiver le mode 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 pour effectuer des WebPartZone opérations programmatiques sur ceux-ci. 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, en les affectant à un WebPartZoneCollection objet, puis effectuer des opérations sur les contrôles enfants ou les différentes propriétés de ce sous-ensemble de zones uniquement.

Voir aussi

• contrôles de composants WebPart ASP.NET