WebPartManager.WebPartsDisconnecting イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
以前に接続した WebPart コントロールまたはサーバー コントロール間の接続を終了するプロセスを実行しているときに発生します。
public:
event System::Web::UI::WebControls::WebParts::WebPartConnectionsCancelEventHandler ^ WebPartsDisconnecting;public event System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler WebPartsDisconnecting;member this.WebPartsDisconnecting : System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler Public Custom Event WebPartsDisconnecting As WebPartConnectionsCancelEventHandler イベントの種類
注釈
イベントは WebPartsDisconnecting メソッドによって OnWebPartsDisconnecting 発生し、ユーザーが切断動詞をクリックしたか、メソッドが呼び出されたという事実を DisconnectWebParts 通知します。 イベントは、接続が完了する前に接続を終了するプロセスを取り消す機会を提供します。 接続が正常に終了すると、このイベントの後に イベントが WebPartsDisconnected 続きます。
ページ開発者は、 属性を 要素に追加 OnWebPartsDisconnecting し、 属性にカスタム メソッド名を <asp:webpartmanager> 割り当てることで、イベントのカスタム ハンドラーを追加できます。
通常、接続を終了する WebPartsDisconnecting ユーザーのアクションの直接の結果としてイベントが発生すると、イベントを取り消すことができます。 ただし、イベントを取り消すことができないシナリオがいくつかあります。 最初のシナリオは、コントロールが削除された場合 WebPartZone 、 WebPart そのコントロールに含まれるコントロールをすべて閉じる必要があり、それ以外の場合は孤立します。 この場合、コントロールは WebPartManager ユーザーではなくコントロールを WebPart 閉じ、接続されているコントロールの接続を中断することなく終了でき、すべてのコントロールをクリーンアップして閉じるプロセスを完了できる必要があります。 したがって、設計上、 WebPartsDisconnecting このシナリオでは メソッドを取り消すことはできません。 取り消すことができる関連イベントについては、 イベントを WebPartClosing 参照してください。
イベントを WebPartsDisconnecting 取り消すことができない 2 つ目のシナリオは、 メソッドが呼び出され (たとえば、ページへの各要求の間に呼び出されます)、ページ上の既存の接続に何らかの種類の競合がある場合 ActivateConnections です。 たとえば、ユーザーはコントロール x をコントロール y に接続しますが、共有ユーザーはコントロール x を接続して z を制御しますが、コントロール x は複数の接続を形成できません。 この場合、接続に対する個々のユーザーの設定が優先され WebPartManager 、コントロールは メソッドを呼び出 DisconnectWebPart し、特定のユーザーの x と z の間の接続を終了することで競合を解決します。 この切断は競合を解決するために不可欠であるため、設計 WebPartsDisconnecting 上、このシナリオではイベントを取り消すことはできません。
メソッドを取り消すことができない 3 番目の WebPartsDisconnecting シナリオは、現在接続されている または サーバー コントロールが削除されているか閉じられている場合 WebPart です。 コントロールは間違いなくページから削除されるため、接続を削除することは論理的に必要です。 したがって、コントロールが メソッドをWebPartManagerDisconnectWebPart呼び出すと、イベントがWebPartsDisconnecting発生します。設計上、イベントを取り消す可能性はありません。
適用対象
こちらもご覧ください
.NET