WebPartManager.SelectedWebPartChanging イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 イベントを参照してください。