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 控件上禁用了个性化设置,则永远不会调用此方法。
在此方法过程中,会发生以下初始化:
获取对默认个性化设置提供程序或页面标记或 ProviderName 属性中指示的WebPartManager自定义提供程序的引用。
调用提供程序以确定当前正在执行的用户 (DetermineUserCapabilities) 的用户功能。
当前页/用户/作用域组合的个性化状态由提供程序从基础数据存储加载, (LoadPersonalizationState) 并存储在实例中 WebPartPersonalization 。
当前页/用户/范围的个性化设置范围由提供程序 (DetermineInitialScope) 确定。 请注意,此确定的结果可能与 属性的值 InitialScope 不同。
此方法返回的范围值用作 属性的值 Scope 。
注意
InvalidOperationException仅当直接调用 方法时,Load才会发生由于未启用个性化设置而导致的异常。 在 ASP.NET 实现中,实际上会调用内部帮助程序方法来执行加载,如果尚未为页面启用个性化设置,则此帮助程序方法以无提示方式返回。