WebPartManager.SelectedWebPartChanging 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
在網頁上變更目前選取之 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
事件類型
備註
這個事件可以與 OnSelectedWebPartChanging 方法搭配使用。 頁面開發人員可以在程式代碼中建立事件處理程式,方法是將 OnSelectedWebPartChanging
屬性新增至 <asp:webpartmanager>
頁面中的 元素,並將 屬性的值設定為將處理事件的自定義方法名稱。
這個事件會在開始或結束控件之間的連接期間引發,以及開始和結束控件的編輯時。 如需詳細資訊,請參閱 OnSelectedWebPartChanging 方法。
一般而言,當 SelectedWebPartChanging 事件引發為變更所選控件之用戶動作的直接結果時,可以取消事件。 不過,有一個案例表示無法取消事件。 WebPartZone如果刪除控件,WebPart則其包含的控件必須全部關閉,否則會遭到遺棄。 在此情況下, WebPartManager 控件會 WebPart 關閉控件,而不是使用者,而且必須判斷目前選取的控件,以及何時要變更選取範圍,而不會中斷任何機率,以便完成清除所有控件的程式。 因此,根據設計, SelectedWebPartChanging 此方法在此案例中無法取消。 如需可取消的相關事件,請參閱 WebPartClosing 事件。