Accueil Library Formation Code Téléchargements Support Evénements Communautés Forums
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

WebPartManager.Zones, propriété

.NET Framework 4.5

Obtient une référence à une collection de toutes les zones WebPartZoneBase d'une page Web.

Espace de noms :  System.Web.UI.WebControls.WebParts
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
[BrowsableAttribute(false)]
public WebPartZoneCollection Zones { get; }

Valeur de propriété

Type : System.Web.UI.WebControls.WebParts.WebPartZoneCollection
WebPartZoneCollection qui référence un jeu de zones WebPartZoneBase.

La propriété Zones est utilisée par le contrôle WebPartManager pour effectuer le suivi des zones WebPartZoneBase d'une page Web. Notez que la propriété ne référence pas tous les types de zones ; elle référence uniquement les zones qui dérivent de la classe WebPartZoneBase, notamment les zones WebPartZone.

Bien que la collection référencée par la propriété soit en lecture seule, vous pouvez l'utiliser pour accéder aux objets individuels de la collection et les utiliser par programme.

L'exemple de code suivant montre comment utiliser la propriété Zones par programme pour accéder aux contrôles de zone WebPartZoneBase individuels. Notez que la balise déclarative de la page Web comporte deux éléments <asp:webpartzone>, chacun contenant un contrôle serveur. Dans la section <script> de la page, le code utilise la propriété Zones pour accéder aux zones individuelles, en répertoriant tous les ID de zone et en modifiant ensuite la couleur d'arrière-plan de la deuxième zone.

C#
VB
Copier 

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    foreach (WebPartZone zone in WebPartManager1.Zones)
    {
      Label1.Text += zone.ID + "<br />";
    }
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartManager1.Zones["WebPartZone2"].BackColor = System.Drawing.Color.LightBlue;
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <div>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links"
            ExportMode="All">
            <asp:ListItem Value="http://www.microsoft.com">
            Microsoft
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
            MSN
            </asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">
            Contoso Corp.
            </asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="List Zone IDs" 
        OnClick="Button1_Click" />
      <asp:Button ID="Button2" runat="server" 
        Text="Change Zone BackColor" 
        OnClick="Button2_Click" />  
      <br />
      <asp:Label ID="Label1" runat="server" text="" />
    </div>
    </form>
</body>
</html>

Pour que l'exemple de code puisse fonctionner, vous devez ajouter un paramètre dans le fichier Web.config pour permettre l'exportation des fichiers de description WebPart. Vérifiez qu'un fichier Web.config est présent dans le même répertoire que la page Web pour cet exemple de code. Dans la section <system.web>, assurez-vous qu'un élément <webParts> contient un attribut enableExport qui a la valeur true, comme dans la balise suivante.

<webParts enableExport="true">

...

</webParts>

Après avoir chargé la page dans un navigateur, si vous cliquez sur le bouton Lister des ID de zone, le code utilise la propriété Zones pour répertorier les ID de toutes les zones de la collection. Si vous cliquez sur le bouton Changer la couleur d'arrière-plan de la zone, le code modifie la couleur d'arrière-plan de la deuxième zone.

.NET Framework

Pris en charge dans : 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité
© 2013 Microsoft. Tous droits réservés.