WebPartManager.Connections プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As WebPartManager Dim value As WebPartConnectionCollection value = instance.Connections
WebPartConnection オブジェクトのセットが格納された WebPartConnectionCollection。
解説Connections プロパティには、ページ上の現在の接続セットにアクセスする方法が用意されています。コレクション自体は読み取り専用のため、開発者がコレクションから特定の接続を操作する場合は、ConnectWebParts や DisconnectWebParts などの WebPartManager メソッドを使用する必要があります。
使用例WebPartManager コントロールを、宣言で使用する方法およびプログラムで使用する方法のコード例を次に示します。
-
接続できる 2 つのカスタム WebPart コントロール、および <asp:webpartmanager> 要素が含まれた Web ページ。
-
2 つのカスタム WebPart コントロールおよび 1 つのカスタム インターフェイスが含まれたソース コード ファイル。
次のコードには、コード例の Web ページ部分のみが含まれています。上で説明したカスタム ユーザー コントロールとカスタム コントロール用のソース コードも必要になります。WebPartManager クラスの概要の「例」からこれら 2 つのアイテムを取得してください。
プログラムで Connections プロパティを使用して、ページ上の現在の接続の数を取得する Web ページのコードを次に示します。<script> タグのセクションでは、WebPartManager コントロールの 2 つのイベントを処理するコードが Connections プロパティにアクセスして接続の数を取得します。
<%@ Page Language="vb" %> <%@ register TagPrefix="uc1" TagName="DisplayModeMenuVB" Src="DisplayModeMenuVB.ascx" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="ConnectionSampleVB" %> <script runat="server"> Protected Sub WebPartManager1_WebPartsConnected( _ ByVal sender As Object, _ ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs) UpdateLabelData(WebPartManager1.WebParts.Count, _ WebPartManager1.Connections.Count) End Sub Protected Sub WebPartManager1_WebPartsDisconnected( _ ByVal sender As Object, _ ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs) UpdateLabelData(WebPartManager1.WebParts.Count, _ WebPartManager1.Connections.Count) End Sub Private Sub UpdateLabelData(ByVal wpCount As Integer, _ ByVal connCount As Integer) Label1.Text = "WebPart Control Count: " & wpCount.ToString() Label2.Text = "Connections Count: " & connCount.ToString() End Sub </script> <html > <head runat="server"> </head> <body> <form id="form1" runat="server"> <!-- Reference the WebPartManager control. --> <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" /> <div> <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" /> <!-- Reference consumer and provider controls in a zone. --> <asp:WebPartZone ID="WebPartZone1" runat="server"> <ZoneTemplate> <aspSample:ZipCodeWebPart ID="zip1" runat="server" Title="Zip Code Control"/> <aspSample:WeatherWebPart ID="weather1" runat="server" Title="Weather Control" /> </ZoneTemplate> </asp:WebPartZone> <hr /> <asp:Label ID="Label1" runat="server" Text=""></asp:Label> <br /> <asp:Label ID="Label2" runat="server" Text=""></asp:Label> <!-- Add a ConnectionsZone so users can connect controls. --> <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" /> </div> </form> </body> </html>
<%@ Page Language="C#" %> <%@ register TagPrefix="uc1" TagName="DisplayModeMenuCS" Src="DisplayModeMenuCS.ascx" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="ConnectionSampleCS" %> <script runat="server"> private void UpdateLabelData(int wpCount, int connCount) { Label1.Text = "WebPart Control Count: " + wpCount.ToString(); Label2.Text = "Connections Count: " + connCount.ToString(); } protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e) { UpdateLabelData(WebPartManager1.WebParts.Count, WebPartManager1.Connections.Count); } protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e) { UpdateLabelData(WebPartManager1.WebParts.Count, WebPartManager1.Connections.Count); } </script> <html > <head id="Head1" runat="server"> </head> <body> <form id="form1" runat="server"> <!-- Reference the WebPartManager control. --> <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" /> <div> <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" /> <!-- Reference consumer and provider controls in a zone. --> <asp:WebPartZone ID="WebPartZone1" runat="server"> <ZoneTemplate> <aspSample:ZipCodeWebPart ID="zip1" runat="server" Title="Zip Code Control"/> <aspSample:WeatherWebPart ID="weather1" runat="server" Title="Weather Control" /> </ZoneTemplate> </asp:WebPartZone> <hr /> <asp:Label ID="Label1" runat="server" Text=""></asp:Label> <br /> <asp:Label ID="Label2" runat="server" Text=""></asp:Label> <!-- Add a ConnectionsZone so users can connect controls. --> <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" /> </div> </form> </body> </html>
ブラウザに Web ページを読み込んだ後、[Display Mode] ドロップダウン リスト コントロールをクリックし、[接続] を選択してページを接続モードに切り替えます。接続モードは、<asp:connectionszone> 要素を使用して、コントロールの間に接続を作成できるようにします。接続モードで、[ZIP Code] コントロールのタイトル バーにある下向きの矢印をクリックしてその動詞メニューをアクティブにし、[接続] をクリックします。接続ユーザー インターフェイス (UI) が表示されたら、[コンシューマへの接続の作成] リンクをクリックします。ドロップダウン リスト コントロールを持つセルが表示されます。ドロップダウン リストの [Weather Control] を選択し、[接続] をクリックして 2 つのコントロールの接続を確立します。[閉じる] をクリックし、[Display Mode] ドロップダウン リストを使用してページを通常のブラウズ モードに戻します。接続の数と WebPart コントロールの数がラベルに表示されます。接続モードに戻って 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- WebPartManager.Connections プロパティのページへのリンク
