WebPartPersonalization.Load 方法

参考

定义

命名空间:: System.Web.UI.WebControls.WebParts

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，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

父 PersonalizationScope 的 WebPartManager 实例。

例外

InvalidOperationException

如果个性化设置未启用（Enabled 等于 false），则调用此方法。

- 或 -

关联的 Page 的 WebPartManager 属性值为 null。

- 或 -

Request 控件的关联 WebPartManager 实例的 Page 属性的值是 null。

ProviderException

页面标记或 ProviderName 属性中显式设置了一个提供程序，但未能找到该提供程序。

- 或 -

包含个性化设置状态数据的对象为 null。

ArgumentException

加载和反序列化数据时出现问题。

- 或 -

配置文件中的个性化设置提供程序的定义出现错误。

ConfigurationErrorsException

基础个性化设置提供程序未能初始化，原因是未能找到默认提供程序或在尝试初始化个性化设置提供程序时出错。

注解

这是代表父 WebPartManager 控件初始化个性化设置信息的主要入口点。此方法在父 WebPartManager 控件的 OnInit 方法期间调用。通常，如果在父 WebPartManager 控件上禁用了个性化设置，则永远不会调用此方法。

在此方法过程中，会发生以下初始化：

获取对默认个性化设置提供程序或页面标记或 ProviderName 属性中指示的WebPartManager自定义提供程序的引用。
调用提供程序以确定当前正在执行的用户 (DetermineUserCapabilities) 的用户功能。
当前页/用户/范围组合的个性化状态由提供程序 () LoadPersonalizationState 从基础数据存储加载并存储在实例中 WebPartPersonalization 。
当前页/用户/作用域的个性化设置范围由提供程序 (DetermineInitialScope) 确定。请注意，此确定的结果可能与属性的值 InitialScope 不同。

此方法返回的范围值用作属性的值 Scope 。

注意

InvalidOperationException仅当直接调用方法时，Load才会发生由于未启用个性化设置而导致的异常。在 ASP.NET 实现中，实际上会调用内部帮助程序方法来执行加载，如果尚未为页面启用个性化设置，则此帮助程序方法会以无提示方式返回。

适用于

WebPartPersonalization.Load 方法

定义

返回

例外

注解

适用于

另请参阅

反馈

其他资源