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 網頁元件控制項