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则调用此方法。
-或-
关联的WebPartManager属性的值Page是 null。
-或-
控件的关联Page实例上的WebPartManager属性的值Request是 null。
基础个性化设置提供程序无法初始化,因为找不到默认提供程序,或者尝试初始化个性化设置提供程序时出错。
注解
这是代表父 WebPartManager 控件初始化个性化设置信息的主要入口点。 此方法在父 WebPartManager 控件 OnInit 的方法期间调用。 通常,如果在父 WebPartManager 控件上禁用了个性化设置,则永远不会调用此方法。
在此方法过程中,将进行以下初始化:
获取对默认个性化设置提供程序或页面标记或属性中指示的ProviderName自定义提供程序的WebPartManager引用。
调用提供程序来确定当前正在执行的用户的用户功能(DetermineUserCapabilities)。
提供程序从LoadPersonalizationState基础数据存储加载当前页/用户/范围组合的个性化状态,并存储在实例中 WebPartPersonalization 。
当前页/用户/范围的个性化范围由提供程序 (DetermineInitialScope) 确定。 请注意,此决定的结果可能与属性的值 InitialScope 不同。
此方法返回的范围值用作属性的值 Scope 。
注释
InvalidOperationException仅当直接调用该方法时,才会发生由于未启用个性化设置而导致的Load异常。 在 ASP.NET 实现中,实际上会调用内部帮助程序方法来执行加载,如果尚未为页面启用个性化设置,则此帮助程序方法将无提示返回。