指定提供程序的名称和实现该提供程序的类。
configuration 元素(常规设置架构)??system.web 元素(ASP.NET 设置架构)
????webParts 元素(ASP.NET 设置架构)
??????webParts 的 personalization 元素(ASP.NET 设置架构)
????????webParts 的 personalization 的 providers 元素(ASP.NET 设置架构)
??????????webParts 的 providers 的 add 元素(ASP.NET 设置架构)
<add name="String" type="String" connectionStringName="String" applicationName="String" commandTimeout="number"/> |
属性和元素
以下几节描述了属性、子元素和父元素。
属性
属性 | 说明 |
---|---|
applicationName |
可选的 String 属性。 指定要存储和检索其个性化设置信息的应用程序的名称。 |
connectionStringName |
必需的 String 属性。 指定用于连接到数据库的特定于 SQL 提供程序的字符串。 |
commandTimeout |
可选的 Int32 属性。 指定向 Web 部件个性化设置数据源发出的命令超时之前等待的秒数。SQL 提供程序在创建 |
name |
必需的 String 属性。 提供程序的友好名称。 |
type |
必需的 String 属性。 指定对某个类的完全限定的程序集引用,该类实现 |
子元素
无。
父元素
元素 | 说明 |
---|---|
configuration |
公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
webParts |
允许您指定 Web 部件个性化设置提供程序、设置个性化设置授权以及添加自定义类(用于扩展 |
personalization |
指定 Web 部件个性化设置提供程序,并设置 Web 部件个性化设置授权。 |
providers |
定义当前 Web 应用程序的 Web 部件个性化设置提供程序。 |
备注
了解下面这一点很重要:如果您的 Web 应用程序不是在默认的信任级别(中等信任)或更高信任级别(您可以在 Web.config 文件中使用 <trust level="" /> 元素设置自定义信任级别)运行,个性化设置将失败。初始化
默认配置
下面的默认 add 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。
? | 复制代码 |
---|---|
<providers> <add name="AspNetSqlPersonalizationProvider" type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider" connectionStringName="LocalSqlServer" /> </providers> |
示例
下面的示例说明如何添加提供程序。
? | 复制代码 |
---|---|
<webParts> <personalization defaultProvider="AspNetSqlPersonalizationProvider"> <providers> <add name="AspNetSqlPersonalizationProvider" type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider" connectionStringName="LocalSqlServer" applicationName="/" /> </providers> </personalization> </webParts> |
只能在计算机、站点和应用程序级别定义提供程序。
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config |
要求 |
IIS 5.0、5.1 和 6.0 .NET Framework 2.0 Visual Studio 2005 |
请参见
任务
参考
system.web 元素(ASP.NET 设置架构)configuration 元素(常规设置架构)
webParts 的 providers 的 clear 元素(ASP.NET 设置架构)
webParts 的 providers 的 remove 元素(ASP.NET 设置架构)
概念
其他资源
常规配置设置 (ASP.NET)ASP.NET 配置设置