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的属性类型失败。

• 尝试反序列化使用二进制序列化的属性类型失败。

• 尝试反序列化属性类型失败，因为无法创建该类型的实例。