語言

WebPartPersonalization.Load 方法

定義

初始化個人化。

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。

提供者在頁面標記 ProviderName 或屬性中明確設定,且找不到提供者。

-或-

包含個人化狀態資料的物件為 null。

在載入與反序列化資料時發生了問題。

-或-

在設定檔中個人化提供者的定義中發生錯誤。

底層的個人化服務提供者未能初始化,是因為找不到預設提供者,或是嘗試初始化個人化服務提供者時發生失敗。

備註

這是代表父 WebPartManager 控組初始化個人化資訊的主要入口。 此方法在父 WebPartManager 控制 OnInit 方法中被呼叫。 通常,若父控制項已關閉 WebPartManager 個人化功能,此方法將不會被呼叫。

在此過程中,會進行以下初始化:

此方法回傳的範圍值即作為屬性的值 Scope 。

Note

InvalidOperationException僅在直接呼叫該方法時,因Load未啟用個人化而產生例外。 在 ASP.NET 實作中,實際上會呼叫一個內部輔助方法來執行載入,若頁面未啟用個人化,該輔助方法會靜默回傳。

適用於

另請參閱