WebPartManager.WebPartsDisconnecting イベント

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

以前に接続した 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

イベントの種類

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します。設計上、イベントを取り消す可能性はありません。

適用対象

こちらもご覧ください