WebPartManager.SelectedWebPartChanging 事件

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

在網頁上變更目前選取之 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 

事件類型

WebPartCancelEventHandler

備註

這個事件可以與 OnSelectedWebPartChanging 方法搭配使用。 頁面開發人員可以在程式代碼中建立事件處理程式，方法是將 OnSelectedWebPartChanging 屬性新增至 <asp:webpartmanager> 頁面中的 元素，並將 屬性的值設定為將處理事件的自定義方法名稱。

這個事件會在開始或結束控件之間的連接期間引發，以及開始和結束控件的編輯時。 如需詳細資訊，請參閱 OnSelectedWebPartChanging 方法。

一般而言，當 SelectedWebPartChanging 事件引發為變更所選控件之用戶動作的直接結果時，可以取消事件。 不過，有一個案例表示無法取消事件。 WebPartZone如果刪除控件，WebPart則其包含的控件必須全部關閉，否則會遭到遺棄。 在此情況下， WebPartManager 控件會 WebPart 關閉控件，而不是使用者，而且必須判斷目前選取的控件，以及何時要變更選取範圍，而不會中斷任何機率，以便完成清除所有控件的程式。 因此，根據設計， SelectedWebPartChanging 此方法在此案例中無法取消。 如需可取消的相關事件，請參閱 WebPartClosing 事件。

另請參閱

• OnSelectedWebPartChanging(WebPartCancelEventArgs)
• ASP.NET 網頁元件控制件