WebPartConnectionsEventArgs クラス

.NET Framework クラス ライブラリ リファレンス

WebPartConnectionsEventArgs クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

WebPartManager コントロールの WebPartsConnected イベントおよび WebPartsDisconnected イベントのイベント データを提供します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class WebPartConnectionsEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As WebPartConnectionsEventArgs

C#

public class WebPartConnectionsEventArgs :
 EventArgs

C++

public ref class WebPartConnectionsEventArgs
 : public EventArgs

J#

public class WebPartConnectionsEventArgs extends
 EventArgs

JScript

public class WebPartConnectionsEventArgs extends
 EventArgs

解説

Web パーツ コントロール セットの機能を使用して、2 つの WebPart または他のサーバー コントロールの間の接続を作成し、1 つのコントロールはプロバイダとして機能させ、もう 1 つのコントロールをデータのコンシューマとして機能させることができます。接続を形成するには、2 つのコントロールが WebPartZoneBase クラスから継承するゾーンに配置され (WebPartZone コントロールなど)、共通のインターフェイスを通じてデータを共有できるように正しく設計されている必要があります。Web パーツ接続の詳細については、「WebPartConnection」および「Web パーツ接続の概要」を参照してください。

WebPartConnectionsEventArgs クラスは、イベントを処理する WebPartConnectionsEventHandler デリゲートを使用するメソッドにイベント データを渡します。イベントを発生させ、WebPartConnectionsEventArgs クラスを使用してイベント データを提供するこのような接続関連のメソッドは 2 つあります。これらはいずれも、WebPartManager コントロールのメンバです。OnWebPartsConnected メソッドは 2 つのサーバー コントロールが正常に接続された後で WebPartsConnected イベントを発生させ、OnWebPartsDisconnected メソッドは 2 つのサーバー コントロールの接続が切断された後で WebPartsDisconnected イベントを発生させます。

開発者は、WebPartsConnected イベントと WebPartsDisconnected イベントのカスタム イベント ハンドラを作成でき、それらのメソッド内で、接続の詳細にアクセスするための WebPartConnectionsEventArgs クラスを使用できます。たとえば、<asp:webpartmanager> 要素で OnWebPartsConnected 属性を宣言し、イベントを処理するカスタム メソッド名にそれを割り当てることができます。カスタム ハンドラ メソッドでは、パラメータとしてメソッドに渡される WebPartConnectionsEventArgs オブジェクトを使用して、接続の詳細にアクセスできます。

WebPartConnectionsEventArgs クラスには、コンストラクタの 2 つのオーバーロードがあります。System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs(WebPart,ProviderConnectionPoint,WebPart,ConsumerConnectionPoint) コンストラクタは既定で、クラスのプロパティ値を初期化します。System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs(WebPart,ProviderConnectionPoint,WebPart,ConsumerConnectionPoint,WebPartConnection) コンストラクタは既定のコンストラクタを呼び出し、Connection プロパティの初期化も行います。

WebPartConnectionsEventArgs クラスにはいくつかのプロパティがあり、それらはすべて、Web パーツ接続に不可欠な要素を参照します。Connection プロパティは、接続全体を表す、関連付けられた WebPartConnection オブジェクトを参照します。Provider プロパティは接続でプロバイダとして機能する WebPart またはその他のコントロールを参照し、Consumer プロパティはコンシューマとして機能する WebPart またはサーバー コントロールを参照します。ProviderConnectionPoint プロパティは接続の ProviderConnectionPoint オブジェクトを参照し、ConsumerConnectionPoint プロパティは ConsumerConnectionPoint オブジェクトを参照します。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
    System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebPartConnectionsEventArgs メンバ
System.Web.UI.WebControls.WebParts 名前空間
WebPartConnectionsEventHandler
WebPartsConnected
WebPartsDisconnected
OnWebPartsConnected
OnWebPartsDisconnected
その他の技術情報
ASP.NET Web パーツ ページ
Web パーツ接続の概要