Freigeben über

WebPartManager.Zones Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft einen Verweis auf eine Auflistung aller WebPartZoneBase Zonen auf einer Webseite ab.

public:
 property System::Web::UI::WebControls::WebParts::WebPartZoneCollection ^ Zones { System::Web::UI::WebControls::WebParts::WebPartZoneCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartZoneCollection Zones { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Zones : System.Web.UI.WebControls.WebParts.WebPartZoneCollection
Public ReadOnly Property Zones As WebPartZoneCollection

Eigenschaftswert

WebPartZoneCollection

Eine WebPartZoneCollection , die auf eine Reihe von WebPartZoneBase Zonen verweist.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der Zones Eigenschaft für den Zugriff auf einzelne WebPartZoneBase Zonensteuerelemente veranschaulicht. Beachten Sie, dass im deklarativen Markup für die Webseite zwei <asp:webpartzone> Elemente vorhanden sind, die jeweils ein Serversteuerelement enthalten. <script> Im Abschnitt der Seite verwendet der Code die Zones Eigenschaft, um auf die einzelnen Zonen zuzugreifen, alle Zonen-IDs aufzulisten und dann die Hintergrundfarbe in der zweiten Zone zu ändern.

<%@ 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>

<%@ Page Language="vb" %>

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

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    Dim zone As WebPartZone
    For Each zone In WebPartManager1.Zones
      Label1.Text += zone.ID & "<br />"
    Next
  End Sub

  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    WebPartManager1.Zones("WebPartZone2").BackColor = _
      System.Drawing.Color.LightBlue
  End Sub
</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>

Beachten Sie, dass Sie für das Codebeispiel eine Einstellung in der datei Web.config hinzufügen müssen, um das Exportieren von Beschreibungsdateien für Webparts zu ermöglichen. Stellen Sie sicher, dass Sie über eine Web.config Datei im selben Verzeichnis wie die Webseite für dieses Codebeispiel verfügen. <system.web> Stellen Sie im Abschnitt sicher, dass ein <webParts> Element mit einem enableExport Attribut vorhanden ist, das wie im folgenden Markup festgelegt trueist.

<webParts enableExport="true">

...

</webParts>

Nachdem Sie die Seite in einen Browser geladen haben, wenn Sie auf die Schaltfläche "Listenzonen-IDs " klicken, verwendet der Code die Zones Eigenschaft zum Auflisten der IDs aller Zonen in der Auflistung. Wenn Sie auf die Schaltfläche " Zone zurückColor ändern" klicken, ändert der Code die Hintergrundfarbe der zweiten Zone.

Hinweise

Die Zones Eigenschaft wird vom WebPartManager Steuerelement verwendet, um die WebPartZoneBase Zonen auf einer Webseite nachzuverfolgen. Beachten Sie, dass die Eigenschaft nicht auf alle Zonentypen verweist; sie verweist nur auf Zonen, die von der WebPartZoneBase Klasse abgeleitet sind, einschließlich WebPartZone Zonen.

Obwohl die Auflistung, auf die von der Eigenschaft verwiesen wird, schreibgeschützt ist, können Sie sie verwenden, um auf die einzelnen Objekte in der Auflistung zuzugreifen und programmgesteuert damit zu arbeiten.

Gilt für: