WebPartManager.OnSelectedWebPartChanging メソッド

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

WebPartManager.OnSelectedWebPartChanging メソッド

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

現在選択されている WebPart コントロールから選択を他に変更するプロセスを実行しているときに発生する、SelectedWebPartChanging イベントを発生させます。

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

Visual Basic (宣言)

Protected Overridable Sub
 OnSelectedWebPartChanging ( _
    e As WebPartCancelEventArgs _
)

Visual Basic (使用法)

Dim e As WebPartCancelEventArgs

Me.OnSelectedWebPartChanging(e)

C#

protected virtual void OnSelectedWebPartChanging
 (
    WebPartCancelEventArgs e
)

C++

protected:
virtual void OnSelectedWebPartChanging (
    WebPartCancelEventArgs^ e
)

J#

protected void OnSelectedWebPartChanging (
    WebPartCancelEventArgs e
)

JScript

protected function OnSelectedWebPartChanging
 (
    e : WebPartCancelEventArgs
)

パラメータ

e

イベント データを格納している WebPartCancelEventArgs。

解説

OnSelectedWebPartChanging メソッドは、現在選択されている WebPart コントロールから選択を他に変更するプロセスを実行しているときに発生する、SelectedWebPartChanging イベントを発生させます。

WebPartManager コントロールは、このメソッドおよび関連付けられたイベントを使用して、選択したコントロールを変更するプロセスをキャンセルすることが可能です。たとえば、BeginWebPartEditing メソッド内および EndWebPartEditing メソッド内でこのメソッドを呼び出すと、そのプロセスをキャンセルできます。編集しているコントロールの Cancel 動詞をユーザーがクリックすると、そのコントロールの選択が解除され、編集中の内容は保存されません。これは、OnSelectedWebPartChanging メソッドを使用して、編集による変更をキャンセルできるためです。

メモ
このメソッドは、ある WebPart コントロールを別のコントロールに接続するプロセスを開始および終了するメソッドでも同様に呼び出され、そのプロセスをキャンセルできます。

ページの開発者は、OnSelectedWebPartChanging 属性を宣言ページ マークアップの <asp:webpartmanager> 要素に追加し、その属性にカスタム メソッドの名前を割り当てることにより、SelectedWebPartChanging イベントのカスタム ハンドラを作成できます。

プラットフォーム

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 名前空間
SelectedWebPartChanged
その他の技術情報
ASP.NET Web パーツ ページ