WebPartPersonalization.Load 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

初始化個人化。

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

父 PersonalizationScope 的 WebPartManager 執行個體。

例外狀況

InvalidOperationException

未啟用個人化時，會呼叫這個方法 (Enabled 等於 false)。

-或-

相關聯 Page 的 WebPartManager 屬性值為 null。

-或-

Request 控制項之相關聯 WebPartManager 執行個體上的 Page 屬性值為 null。

ProviderException

已在網頁標記或 ProviderName 屬性中明確設定提供者，但找不到該提供者。

-或-

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

ArgumentException

載入和還原序列化資料時發生問題。

-或-

定義組態檔中的個人化提供者時發生錯誤。

ConfigurationErrorsException

因為找不到預設提供者，或因為嘗試初始化個人化提供者失敗，所以基礎個人化提供者無法初始化。

備註

這是代表父 WebPartManager 控制項初始化個人化資訊的主要進入點。 這個方法會在父 WebPartManager 控制項 OnInit 的 方法期間呼叫。 一般而言，如果父 WebPartManager 控制項上已停用個人化，則永遠不會呼叫這個方法。

在此方法的過程中，會發生下列初始化：

• 取得預設個人化提供者或頁面標記或 屬性中所 WebPartManager 指出之自訂提供者的 ProviderName 參考。

• 系統會呼叫 提供者，以判斷目前執行中使用者的使用者 (DetermineUserCapabilities) 功能。

• 提供者會從基礎資料存放區載入目前頁面/使用者/範圍組合的個人化狀態 () LoadPersonalizationState 並儲存在 實例內 WebPartPersonalization 。

• 目前頁面/使用者/範圍的個人化範圍是由提供者 (DetermineInitialScope) 決定。 請注意，此判斷的結果可能與 屬性的值 InitialScope 不同。

從這個方法傳回的範圍值會當做 屬性的值 Scope 使用。

注意

InvalidOperationException只有在直接呼叫 方法時 Load ，才會發生因未啟用個人化而造成的例外狀況。 在 ASP.NET 實作中，實際上會呼叫內部協助程式方法來執行載入，而且如果頁面尚未啟用個人化，這個協助程式方法會以無訊息方式傳回。

另請參閱

• WebPartPersonalization
• ASP.NET 網頁元件控制項
• Web 元件個人化概觀
• 逐步解說：使用使用者控制項實作 Web 元件個人化
• 網頁元件個人化