WebPartManager.SelectedWebPartChanging イベント

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

WebPartManager.SelectedWebPartChanging イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

Web ページ上で現在選択されている WebPart コントロールまたはサーバー コントロールの変更プロセス中に発生します。

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

Visual Basic (宣言)

Public Event SelectedWebPartChanging As
 WebPartCancelEventHandler

Visual Basic (使用法)

Dim instance As WebPartManager
Dim handler As WebPartCancelEventHandler

AddHandler instance.SelectedWebPartChanging, handler

C#

public event WebPartCancelEventHandler SelectedWebPartChanging

C++

public:
event WebPartCancelEventHandler^ SelectedWebPartChanging {
    void add (WebPartCancelEventHandler^ value);
    void remove (WebPartCancelEventHandler^ value);
}

J#

/** @event */
public void add_SelectedWebPartChanging (WebPartCancelEventHandler
 value)

/** @event */
public void remove_SelectedWebPartChanging
 (WebPartCancelEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、OnSelectedWebPartChanging メソッドと組み合わせて使用できます。ページの開発者は、ページの <asp:webpartmanager> 要素に OnSelectedWebPartChanging 属性を追加し、このイベントを処理するカスタム メソッドの名前をその属性の値に設定することにより、各自のコードにイベント ハンドラを作成できます。

このイベントは、コントロール間の接続を開始または終了するプロセスを実行しているとき、およびコントロールの編集を開始および終了するときに発生します。詳細については、OnSelectedWebPartChanging メソッドのトピックを参照してください。

通常、選択されたコントロールを変更するユーザー操作の直接の結果として SelectedWebPartChanging イベントが発生した場合、このイベントをキャンセルできます。しかし、イベントをキャンセルできない場合もあります。WebPartZone コントロールが削除された場合、それに含まれる WebPart コントロールはすべて閉じる必要があります。そうしないと、それらは孤立することになります。この場合、ユーザーではなく WebPartManager コントロールが WebPart コントロールを閉じ、どのコントロールが現在選択されているのか、および中断を発生させずにいつ選択を変更するのかを判断して、すべのコントロールをクリーンアップする処理を完了できるようにする必要があります。したがって、仕様上、この状況では SelectedWebPartChanging メソッドはキャンセルできません。キャンセルできる関連イベントについては、WebPartClosing イベントのトピックを参照してください。

プラットフォーム

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

参照

関連項目
WebPartManager クラス
WebPartManager メンバ
System.Web.UI.WebControls.WebParts 名前空間
OnSelectedWebPartChanging
その他の技術情報
ASP.NET Web パーツ ページ