WebPartZoneCollection Constructeurs
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 du jeu de contrôles De composants 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
S’applique à
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.WebPartZoneCollectionPublic Sub New (webPartZones As ICollection)Paramètres
- webPartZones
- ICollection
ICollection d'objets WebPartZone.
Exceptions
La collection de zones a la valeur null.
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.
