WebPartManager.SelectedWebPartChanging イベント

定義

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

public:
 event System::Web::UI::WebControls::WebParts::WebPartCancelEventHandler ^ SelectedWebPartChanging;
public event System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler SelectedWebPartChanging;
member this.SelectedWebPartChanging : System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler 
Public Custom Event SelectedWebPartChanging As WebPartCancelEventHandler 

イベントの種類

注釈

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

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

通常、選択したコントロールを SelectedWebPartChanging 変更するユーザーのアクションの直接の結果としてイベントが発生すると、イベントを取り消すことができます。 ただし、イベントを取り消すことができないシナリオがあります。 コントロールが WebPartZone 削除された場合は、コントロールに WebPart 含まれるコントロールをすべて閉じる必要があります。それ以外の場合は孤立します。 この場合 WebPartManager 、コントロールはユーザーではなくコントロールを WebPart 閉じ、現在選択されているコントロールと、中断することなく選択を変更するタイミングを決定して、すべてのコントロールをクリーンアップするプロセスを完了する必要があります。 したがって、設計上、 SelectedWebPartChanging このシナリオでは メソッドを取り消すことはできません。 取り消すことができる関連イベントについては、 イベントを WebPartClosing 参照してください。

適用対象

こちらもご覧ください