SqlPersonalizationProvider 类

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

实现一个使用 Microsoft SQL Server 的个性化设置提供程序。

public ref class SqlPersonalizationProvider : System::Web::UI::WebControls::WebParts::PersonalizationProvider

public class SqlPersonalizationProvider : System.Web.UI.WebControls.WebParts.PersonalizationProvider

type SqlPersonalizationProvider = class
    inherit PersonalizationProvider

Public Class SqlPersonalizationProvider
Inherits PersonalizationProvider

继承

Object

ProviderBase

PersonalizationProvider

SqlPersonalizationProvider

注解

此类使用 Microsoft SQL Server 定义个性化设置提供程序所需的功能。 个性化设置提供程序代表实例加载和存储个性化设置数据 WebPartPersonalization 。 此类实现从运行 SQL Server 的计算机读取和写入的逻辑，还实现 中 PersonalizationProvider定义的所有抽象方法。 有关个性化设置提供程序的详细信息，请参阅 PersonalizationProvider。

将 Web 部件个性化与 SQL Server 配合使用的数据设计依赖于存在两个常见的 SQL 数据库表及其支持的存储过程，这些表为大多数基于 SQL 的功能实现共享。 使用以下脚本安装和卸载这些表和视图：

• installpagepersonalization.sql - 安装个性化设置表、视图和相关存储过程。

• uninstallpagepersonalization.sql - 卸载个性化设置表、视图和相关存储过程。

请务必注意，如果 Web 应用程序未在默认信任级别或更高级别 Medium 运行，个性化设置会失败， (可以使用 元素) 在 Web.config 文件中 <trust level="" /> 设置自定义信任级别。 PersonalizationAdministration和 SqlPersonalizationProvider 类在初始化时会检查 的信任级别Low。 如果将应用程序配置为在 信任级别 Low运行，并使用默认 SqlPersonalizationProvider 提供程序管理应用程序的个性化设置数据，则应用程序首次尝试访问个性化设置数据时，它将失败，因为以信任方式 Low 运行的 ASP.NET 工作进程没有调用命名空间中 System.Data.SqlClient 各种类所需的权限。

构造函数

SqlPersonalizationProvider()

初始化 SqlPersonalizationProvider 类的新实例。

属性

ApplicationName	获取或设置要存储和检索其个性化设置信息的应用程序的名称。
Description	获取一条简短的易懂描述，它适合在管理工具或其他用户界面 (UI) 中显示。 (继承自 ProviderBase)
Name	获得一个友好名称，用于在配置过程中引用提供程序。 (继承自 ProviderBase)

方法

CreateSupportedUserCapabilities()	返回 WebPartUserCapability 对象的列表，这些对象表示 Web 部件控件集所使用的已知功能集。 (继承自 PersonalizationProvider)
DetermineInitialScope(WebPartManager, PersonalizationState)	确定初始个性化设置范围应为 Shared 还是 User 范围。 (继承自 PersonalizationProvider)
DetermineUserCapabilities(WebPartManager)	返回一个包含 WebPartUserCapability 实例的字典，这些实例表示当前正在执行的用户帐户的与个性化设置相关的功能。 (继承自 PersonalizationProvider)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	根据指定范围和参数返回一个包含零个或零个以上 PersonalizationStateInfo 派生对象的集合。
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)	返回针对指定 scope 参数的基础数据存储区的行数。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
Initialize(String, NameValueCollection)	实现 Microsoft SQL Server 个性化设置提供程序所需的初始化过程。 此方法不能直接在代码中使用。
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])	根据指定参数从基础数据存储区加载个性化设置数据。
LoadPersonalizationState(WebPartManager, Boolean)	从基础数据存储区加载原始数据，并将该数据转换为 PersonalizationState 对象。 (继承自 PersonalizationProvider)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ResetPersonalizationBlob(WebPartManager, String, String)	从基础数据存储区中删除个性化设置数据。
ResetPersonalizationState(WebPartManager)	将个性化设置数据重置到基础数据存储区。 (继承自 PersonalizationProvider)
ResetState(PersonalizationScope, String[], String[])	根据指定参数从基础数据存储区中删除个性化设置状态信息。
ResetUserState(String, DateTime)	根据指定参数从基础数据存储区删除用户个性化设置数据。
SavePersonalizationBlob(WebPartManager, String, String, Byte[])	将原始个性化设置数据保存到基础 Microsoft SQL Server 数据库中。
SavePersonalizationState(PersonalizationState)	将个性化设置数据保存到数据存储区中。 (继承自 PersonalizationProvider)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• PersonalizationProvider
• ASP.NET Web 部件控件
• Web 部件个性化概述
• 演练：使用用户控件实现 Web 部件个性化
• Web 部件个性化