WebPartManager.Zones プロパティ
アセンブリ: System.Web (system.web.dll 内)

WebPartZoneBase ゾーンのセットを参照する WebPartZoneCollection。

WebPartManager コントロールは、Zones プロパティを使用して、Web ページ上の WebPartZoneBase ゾーンを追跡します。このプロパティはすべての種類のゾーンは参照するわけではありません。参照するのは、WebPartZone ゾーンを含め、WebPartZoneBase クラスから派生したゾーンだけです。
このプロパティが参照するコレクションは読み取り専用ですが、これを使用してコレクション内の個々のオブジェクトにアクセスすると、プログラムでこれらを操作できます。

プログラムで Zones プロパティを使用して個々の WebPartZoneBase ゾーン コントロールにアクセスする方法のコード例を次に示します。Web ページの宣言マークアップには 2 つの <asp:webpartzone> 要素があり、それぞれにサーバー コントロールが含まれています。ページの <script> セクションでは、コードが Zones プロパティを使用して個々のゾーンにアクセスし、すべてのゾーン ID をリストして 2 番目のゾーンの背景色を変更します。
<%@ Page Language="C#" %> <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 > <head id="Head1" runat="server"> </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" %> <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 > <head id="Head1" runat="server"> </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>
コード例が機能するには、Web.config ファイルに設定を追加して、Web パーツ記述ファイルをエクスポートできるようにする必要があります。このコード例の Web ページと同じディレクトリ内に Web.config ファイルが存在することを確認してください。<system.web> セクション内に、次のマークアップのように、true に設定された enableExport 属性を持つ <webParts> 要素が存在することを確認します。
<webParts enableExport="true">
...
</webParts>
ブラウザにページを読み込んだ後、[List Zone IDs] をクリックすると、コードは Zones プロパティを使用して、コレクション内のすべてのゾーンの ID をリストします。[Change Zone BackColor] をクリックすると、コードが 2 番目のゾーンの背景色を変更します。

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Weblioに収録されているすべての辞書からWebPartManager.Zones プロパティを検索する場合は、下記のリンクをクリックしてください。

- WebPartManager.Zones プロパティのページへのリンク