webParts 的 providers 的 add 元素（ASP.NET 设置架构）

项目
09/04/2008

更新：2007 年 11 月

指定提供程序的名称和实现该提供程序的类。

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 提供程序在创建 SqlCommand 对象时，将使用该超时属性。默认情况下 ASP.NET 配置中并未设置该属性。因此，使用 ADO.NET 默认值 30 秒。如果设置了该属性，则 SQL 提供程序对向数据库发出的所有 SQL 命令使用配置的超时值。
name	必需的 String 属性。提供程序的友好名称。
type	必需的 String 属性。指定对某个类的完全限定的程序集引用，该类实现 PersonalizationProvider 基类。根据包含提供程序的代码所在位置，该引用可以是部分引用（例如，仅 Namespace.ClassName，或 Namespace.Classname 和 AssemblyName），也可以是对实现 PersonalizationProvider 基类的类的完全限定的程序集引用。

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素，这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。
webParts	允许您指定 Web 部件个性化设置提供程序、设置个性化设置授权以及添加自定义类（用于扩展 WebPartTransformer 类供 Web 部件连接使用）。
personalization	指定 Web 部件个性化设置提供程序，并设置 Web 部件个性化设置授权。
providers	定义当前 Web 应用程序的 Web 部件个性化设置提供程序。

备注

了解下面这一点很重要：如果您的 Web 应用程序不是在默认的信任级别（中等信任）或更高信任级别（您可以在 Web.config 文件中使用 <trust level="" /> 元素设置自定义信任级别）运行，个性化设置将失败。初始化 PersonalizationAdministration 和 SqlPersonalizationProvider 类时，这两个类都会检查 Low 的信任级别。如果您将应用程序配置为在 Low 信任级别运行，并且使用默认的 SqlPersonalizationProvider 来管理应用程序的个性化设置数据，则应用程序首次尝试访问个性化设置数据时将会失败，因为以低信任级别运行的 ASP.NET 辅助进程无权调用 System.Data.SqlClient 命名空间中的各种类。

默认配置

下面的默认 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>

只能在计算机、站点和应用程序级别定义提供程序。

元素信息

配置节处理程序	System.Web.Configuration.WebPartsSection
配置成员	WebPartsPersonalization.Providers
可配置的位置	Machine.config 根级别的 Web.config 应用程序级别的 Web.config
要求	IIS 5.0、5.1 和 6.0 .NET Framework 2.0 Visual Studio 2005

请参见

通过

webParts 的 providers 的 add 元素（ASP.NET 设置架构）

属性和元素

属性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

概念

参考

其他资源

其他资源