PersonalizationProvider 类

定义

实现个性化设置提供程序的基本功能。

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
type PersonalizationProvider = class
    inherit ProviderBase
Public MustInherit Class PersonalizationProvider
Inherits ProviderBase
继承
PersonalizationProvider
派生

注解

这是定义个性化设置提供程序所需功能的抽象基类。 个性化设置提供程序代表 WebPartPersonalization 实例加载和存储个性化设置数据。

基类定义许多方法的标准行为;仅那些专门处理基础数据存储的方法被标记为抽象。 这允许开发人员编写自定义提供程序来与特定数据存储进行交互,而无需重新实现 类使用 WebPartPersonalization 的标准功能。

实施者说明

你可以从 PersonalizationProvider 派生,并仅为此类中定义的抽象方法提供实现。 抽象方法专门处理将数据保存和加载到物理数据存储以及数据存储管理。 自定义提供程序必须能够以区分 Shared 数据与 User 数据的方式操作个性化设置信息。 此外,提供程序必须按页面和应用程序对个性化数据进行分段。

PersonalizationProvider 实现与 的实现 PersonalizationState 紧密耦合,因为某些个性化设置提供程序方法返回 派生类的 PersonalizationState实例。 为了简化自定义提供程序的开发, PersonalizationProvider 基类包括由 类直接 WebPartPersonalization 使用的个性化设置逻辑和序列化/反序列化逻辑的默认实现。 因此,仅出于处理不同数据存储的目的创作自定义提供程序只需要实现以下抽象方法:

在所有这些方法中,如果仅提供路径,则指示正在操作页面的共享个性化设置数据。 如果路径和用户名都传递给方法,则应对页面的用户个性化数据执行操作。 对于 LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]),应始终加载指定路径的共享数据,如果用户名不是 null,则还可以选择加载路径的用户个性化数据。

所有其他抽象方法仅用于管理应用程序,在运行时不由 Web 部件基础结构使用。 有关个性化设置提供程序实现的示例,请参阅 SqlPersonalizationProvider 类。

构造函数

PersonalizationProvider()

初始化 PersonalizationProvider 类的新实例。

属性

ApplicationName

在派生类中重写时,获取或设置为提供程序配置的应用程序的名称。

Description

获取一条简短的易懂描述,它适合在管理工具或其他用户界面 (UI) 中显示。

(继承自 ProviderBase)
Name

获得一个友好名称,用于在配置过程中引用提供程序。

(继承自 ProviderBase)

方法

CreateSupportedUserCapabilities()

返回 WebPartUserCapability 对象的列表,这些对象表示 Web 部件控件集所使用的已知功能集。

DetermineInitialScope(WebPartManager, PersonalizationState)

确定初始个性化设置范围应为 Shared 还是 User 范围。

DetermineUserCapabilities(WebPartManager)

返回一个包含 WebPartUserCapability 实例的字典,这些实例表示当前正在执行的用户帐户的与个性化设置相关的功能。

Equals(Object)

确定指定对象是否等于当前对象。

(继承自 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)

在派生类中重写时,将根据范围和特定的查询参数返回一个集合,其中包含零个或零个以上 PersonalizationStateInfo 派生对象。

GetCountOfState(PersonalizationScope, PersonalizationStateQuery)

在派生类中重写时,返回基础数据存储区中存在于指定范围内的行数。

GetHashCode()

作为默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
Initialize(String, NameValueCollection)

初始化配置生成器。

(继承自 ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])

在派生类中重写时,从基础数据存储区加载原始个性化设置数据。

LoadPersonalizationState(WebPartManager, Boolean)

从基础数据存储区加载原始数据,并将该数据转换为 PersonalizationState 对象。

MemberwiseClone()

创建当前 Object 的浅表副本。

(继承自 Object)
ResetPersonalizationBlob(WebPartManager, String, String)

在派生类中重写时,从基础数据存储区删除原始个性化设置数据。

ResetPersonalizationState(WebPartManager)

将个性化设置数据重置到基础数据存储区。

ResetState(PersonalizationScope, String[], String[])

在派生类中重写时,根据指定的参数从基础数据存储区删除个性化设置状态。

ResetUserState(String, DateTime)

在派生类中重写时,根据指定的参数从基础数据存储区删除 Web 部件个性化设置数据。

SavePersonalizationBlob(WebPartManager, String, String, Byte[])

在派生类中重写时,将原始个性化设置数据保存到基础数据存储区中。

SavePersonalizationState(PersonalizationState)

将个性化设置数据保存到数据存储区中。

ToString()

返回表示当前对象的字符串。

(继承自 Object)

适用于

另请参阅