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