WebPartPersonalization.Load 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化個人化。
protected:
virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope
傳回
一個 PersonalizationScope 為父本 WebPartManager的實例。
例外狀況
當未啟用Enabled 個人化(等於 false)時,此方法稱為 。
-或-
該屬性對關聯Page的價值WebPartManager為 null。
-或-
該屬性在控制項相關Request實例上的WebPartManager值Page為 null。
底層的個人化服務提供者未能初始化,是因為找不到預設提供者,或是嘗試初始化個人化服務提供者時發生失敗。
備註
這是代表父 WebPartManager 控組初始化個人化資訊的主要入口。 此方法在父 WebPartManager 控制 OnInit 方法中被呼叫。 通常,若父控制項已關閉 WebPartManager 個人化功能,此方法將不會被呼叫。
在此過程中,會進行以下初始化:
會取得預設個人化服務提供者,或頁面標記WebPartManager或屬性中指定的ProviderName自訂提供者參考。
使用者會被呼叫以判定目前執行使用者的使用者能力DetermineUserCapabilities()。
目前頁面/使用者/範圍組合的個人化狀態由提供者LoadPersonalizationState()從底層資料儲存載入並儲存在實例中 WebPartPersonalization 。
目前頁面/使用者/範圍的個人化範圍由提供者DetermineInitialScope()決定。 請注意,此判定結果可能與房產價值 InitialScope 不同。
此方法回傳的範圍值即作為屬性的值 Scope 。
Note
InvalidOperationException僅在直接呼叫該方法時,因Load未啟用個人化而產生例外。 在 ASP.NET 實作中,實際上會呼叫一個內部輔助方法來執行載入,若頁面未啟用個人化,該輔助方法會靜默回傳。