WebPartManager.OnSelectedWebPartChanged(WebPartEventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
事件升級 SelectedWebPartChanged ,發生在 WebPart 控制點被新選定或已清除後。
protected:
virtual void OnSelectedWebPartChanged(System::Web::UI::WebControls::WebParts::WebPartEventArgs ^ e);
protected virtual void OnSelectedWebPartChanged(System.Web.UI.WebControls.WebParts.WebPartEventArgs e);
abstract member OnSelectedWebPartChanged : System.Web.UI.WebControls.WebParts.WebPartEventArgs -> unit
override this.OnSelectedWebPartChanged : System.Web.UI.WebControls.WebParts.WebPartEventArgs -> unit
Protected Overridable Sub OnSelectedWebPartChanged (e As WebPartEventArgs)
參數
WebPartEventArgs A 包含事件資料。
備註
此 OnSelectedWebPartChanged 方法會 SelectedWebPartChanged 觸發事件,通常是開發者可能想要更改使用者介面(UI)外觀的某個時間點。 例如,當選取新 WebPart 控制項時,Web Parts 控制集會改變該控制項的渲染方式。 當控制項選擇被清除後,渲染會回復正常。
使用者選擇 WebPart 特定控制項進行編輯後, OnSelectedWebPartChanged 該方法就會被呼叫。 當使用者完成編輯控制項並關閉控制項,且控制項的選取被清除後, OnSelectedWebPartChanged 該方法會再次被呼叫。
給繼承者的注意事項
有多種與事件相關的 SelectedWebPartChanged 選項,讓開發者能自訂在所選控制項變更後的渲染效果。 在宣告式程式碼中,你可以在元素中 <asp:webpartmanager> 設定 OnSelectedWebPartChanged 屬性,並指派自訂方法的名稱。 在自訂方法中,你可以在事件發生時修改選取控制項的渲染方式。 另一個選擇是繼承該 WebPartManager 類別並覆寫該方法。 第三種選項是在區域層級自訂渲染;例如,你可以從 EditorZoneBase 類別繼承並覆寫其 OnSelectedWebPartChanged(Object, WebPartEventArgs) 方法,以自訂編輯過程中選取與清除的控制項的渲染方式。