WebPartManager.WebPartsDisconnecting 事件

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

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

適用於

另請參閱

• OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)
• WebPartsDisconnected
• DisconnectWebParts(WebPartConnection)
• ASP.NET 網頁元件控制件