ProxyWebPartManager.StaticConnections プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As ProxyWebPartManager Dim value As ProxyWebPartConnectionCollection value = instance.StaticConnections
public: property ProxyWebPartConnectionCollection^ StaticConnections { ProxyWebPartConnectionCollection^ get (); }
<asp:proxywebpartmanager> 要素で宣言されているすべての静的な WebPartConnection オブジェクトを格納する ProxyWebPartConnectionCollection。
解説StaticConnections プロパティは、<asp:proxywebpartmanager> 要素で宣言されている WebPartConnection オブジェクトのコレクションを参照します。このコレクションに格納されている接続は、WebPartManager.StaticConnections コレクションによって参照される WebPartManager コントロール の静的接続に追加され、WebPartManager コントロールに関連付けられている他の接続とまったく同様に扱われます。
StaticConnections プロパティに対応する宣言要素は <staticconnections> 要素です。マスタ ページを使用するアプリケーションでは、<staticconnections> 要素がコンテンツ ページの <asp:proxywebpartmanager> 要素の子として追加され、<asp:webpartconnection> 要素が <staticconnections> 要素の子として追加されます。1 つの <staticconnections> 要素には複数の <asp:webpartconnection> 要素を追加でき、複数のコンテンツ ページはマスタ ページ アプリケーションの一部として静的接続を宣言できます。
使用例ProxyWebPartManager クラスの StaticConnections プロパティの使用方法を次のコード例に示します。このコード例では、ProxyWebPartManager コントロールと静的接続を宣言するコンテンツ ページのコードの関連部分だけを示しています。コードの実行に必要なその他のページと、その設定方法の説明については、ProxyWebPartManager クラスの概要の「使用例」を参照してください。
次のコードは、<staticconnections> 要素を <asp:proxywebpartmanager> 要素の子として宣言するコンテンツ ページです。また、Button1_Click メソッドは ProxyWebPartManager コントロールの StaticConnections プロパティの数を確認し、それをページに書き込みます。
<%@ Page Language="VB" MasterPageFile="~/MasterPageVB.master" Title="Connections Page" %> <%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" %> <script runat="server"> Protected Sub Button1_Click(ByVal sender As Object, _ ByVal e As EventArgs) Dim lblText As StringBuilder = New StringBuilder() If Not (Page.Master.FindControl("WebPartManager1") Is Nothing) Then Dim theMgr As WebPartManager = _ CType(Page.Master.FindControl("WebPartManager1"), WebPartManager) lblText.Append("WebPartManager: <br /><pre>" & _ " Master page file is " & Page.MasterPageFile & "<br />" & _ " ID is " & theMgr.ID & "<br />" & _ " Connection count is " & _ theMgr.StaticConnections.Count.ToString() & "<br />" & _ " WebParts count is " & _ theMgr.WebParts.Count.ToString() & "</pre><br />") End If If Not (proxymgr1 Is Nothing) Then lblText.Append("ProxyWebPartManager: <br /><pre>" & _ " Content page file is " & Request.Path & "<br />" & _ " ID is " & proxymgr1.ID & "<br />" & _ " Connection count is " & _ proxymgr1.StaticConnections.Count.ToString() & "</pre><br />") End If Literal1.Text = lblText.ToString() End Sub </script> <asp:Content ID="Content1" Runat="Server" ContentPlaceHolderID="ContentPlaceHolder1" > <asp:proxywebpartmanager id="proxymgr1" runat="server"> <staticconnections> <asp:webpartconnection id="connection1" consumerconnectionpointid="ZipCodeConsumer" consumerid="zipConsumer" providerconnectionpointid="ZipCodeProvider" providerid="zipProvider" /> </staticconnections> </asp:proxywebpartmanager> <div> <asp:webpartzone id="zone1" runat="server"> <zonetemplate> <aspsample:zipcodewebpart id="zipProvider" runat="server" title="Zip Code Provider" /> <aspsample:weatherwebpart id="zipConsumer" runat="server" title="Zip Code Consumer" /> </zonetemplate> </asp:webpartzone> </div> <div> <asp:button id="Button1" runat="server" text="WebPartManager Information" onclick="Button1_Click" /> <br /> <asp:literal id="Literal1" runat="server" /> </div> <asp:connectionszone id="ConnectionsZone1" runat="server" /> </asp:Content>
<%@ Page Language="C#" MasterPageFile="~/MasterPageCS.master" Title="Connections Page" %> <%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" %> <script runat="server"> protected void Button1_Click(object sender, EventArgs e) { StringBuilder lblText = new StringBuilder(); if (Page.Master.FindControl("WebPartManager1") != null) { WebPartManager theMgr = (WebPartManager)Page.Master.FindControl("WebPartManager1"); lblText.Append("WebPartManager: <br /><pre>" + " Master page file is " + Page.MasterPageFile + "<br />" + " ID is " + theMgr.ID + "<br />" + " Connection count is " + theMgr.StaticConnections.Count.ToString() + "<br />" + " WebParts count is " + theMgr.WebParts.Count.ToString() + "</pre><br />"); } if (proxymgr1 != null) { lblText.Append("ProxyWebPartManager: <br /><pre>" + " Content page file is " + Request.Path + "<br />" + " ID is " + proxymgr1.ID + "<br />" + " Connection count is " + proxymgr1.StaticConnections.Count.ToString() + "</pre><br />"); } Literal1.Text = lblText.ToString(); } </script> <asp:Content ID="Content1" Runat="Server" ContentPlaceHolderID="ContentPlaceHolder1" > <asp:proxywebpartmanager id="proxymgr1" runat="server"> <staticconnections> <asp:webpartconnection id="connection1" consumerconnectionpointid="ZipCodeConsumer" consumerid="zipConsumer" providerconnectionpointid="ZipCodeProvider" providerid="zipProvider" /> </staticconnections> </asp:proxywebpartmanager> <div> <asp:webpartzone id="zone1" runat="server"> <zonetemplate> <aspsample:zipcodewebpart id="zipProvider" runat="server" title="Zip Code Provider" /> <aspsample:weatherwebpart id="zipConsumer" runat="server" title="Zip Code Consumer" /> </zonetemplate> </asp:webpartzone> </div> <div> <asp:button id="Button1" runat="server" text="WebPartManager Information" onclick="Button1_Click" /> <br /> </div> <asp:connectionszone id="ConnectionsZone1" runat="server" /> <asp:literal id="Literal1" runat="server" /> </asp:Content>
ページをブラウザに読み込んだら、[WebPartManager Information] ボタンをクリックして、マスタ ページの WebPartManager コントロールに関する情報とコンテンツ ページの ProxyWebPartManager コントロールに関する情報を確認します。たとえば、それぞれのコントロールの静的接続を追跡するプロパティ (StaticConnections プロパティ) の値は同じです。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- ProxyWebPartManager.StaticConnections プロパティのページへのリンク
