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 是在 ActivateConnections 每次對頁面的要求期間呼叫此方法 (呼叫，例如) ，且頁面上現有連接發生某種類型的衝突。 例如，使用者或許會將 control x 連接到控制項 y，但共用使用者會將 control x 連接到 control z，但不允許控制項 x 形成多個連接。 在此情況下，個別使用者的連線設定優先，而 WebPartManager 控制項會呼叫 DisconnectWebPart 方法並結束特定使用者之間的連線，以解決衝突。 由於此中斷連線對於解決衝突很重要，因此在此案例中無法取消事件。 WebPartsDisconnecting

無法取消方法的第三個案例 WebPartsDisconnecting 是在目前連接的 或 伺服器控制項遭到刪除或關閉時 WebPart 。 因為控制項一定會從頁面移除，所以移除其連線是邏輯必要條件。 因此，當 WebPartManager 控制項叫用 DisconnectWebPart 方法時，它會依設計引發 WebPartsDisconnecting 事件，因此無法取消事件。

適用於

另請參閱