PersonalizationProvider.LoadPersonalizationState 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

從基礎資料存放區載入未經處理的資料，並將該資料轉換成 PersonalizationState 物件。

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationState ^ LoadPersonalizationState(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, bool ignoreCurrentUser);
public virtual System.Web.UI.WebControls.WebParts.PersonalizationState LoadPersonalizationState (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, bool ignoreCurrentUser);
abstract member LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
override this.LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
Public Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationState

參數

webPartManager
WebPartManager

WebPartManager，管理個人化資料。

ignoreCurrentUser
Boolean

Boolean，指出是否應該將使用者名稱傳遞給個人化提供者。

傳回

PersonalizationState

PersonalizationState，包含個人化資料。

例外狀況

ArgumentNullException

webPartManager 為 null。

ArgumentException

與 webPartManager 關聯的頁面為 null。

-或-

與網頁關聯的要求為 null。

備註

這個方法是 類別用來 WebPartPersonalization 載入個人化資料的主要進入點。 預設實作會從基礎資料存放區載入原始資料， (功能是在衍生提供者中實作) ，然後將原始資料轉換成 PersonalizationState 實例。

ignoreCurrentUser如果 參數為 true ，則不會將使用者名稱傳遞至 LoadPersonalizationBlobs 方法。 個人化提供者可以選擇將此解譯為，這表示只應該從基礎資料存放區擷取具有 Shared 範圍的個人化狀態。

Load當方法執行時，它會呼叫 LoadPersonalizationState 方法，而且當載入狀態時，可能會發生三種類型的還原序列化錯誤。 發生這些特定錯誤時，不會擲回任何例外狀況，而且健康情況監視功能會改為記錄錯誤事件 (，以取得健康情況監視和存取其所建立記錄的資訊，請參閱 ASP.NET 健全狀況監視概觀) 。 下列三種案例會導致還原序列化錯誤事件寫入記錄檔：

  • 嘗試還原序列化使用字串 TypeConverter 的屬性類型失敗。

  • 嘗試還原序列化使用二進位序列化的屬性類型失敗。

  • 無法還原序列化屬性類型，因為無法建立類型的實例。

適用於