webParts 的 personalization 的 providers 元素(ASP.NET 设置架构)

更新:2007 年 11 月

定义当前 Web 应用程序的 Web 部件个性化设置提供程序。

configuration 元素(常规设置架构)
  system.web 元素(ASP.NET 设置架构)
    webParts 元素(ASP.NET 设置架构)
      webParts 的 personalization 元素(ASP.NET 设置架构)
        webParts 的 personalization 的 providers 元素(ASP.NET 设置架构)

<providers>
    <add.../>
    <clear />
    <remove.../>
</providers>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

无。

子元素

元素

说明

add

可选的元素

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

clear

可选的元素

从集合中移除所有 Web 部件提供程序。

remove

可选的元素

从集合中移除指定的 Web 部件提供程序。

父元素

元素

说明

configuration

公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素。包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。

webParts

允许您指定 Web 部件个性化设置提供程序、设置个性化设置授权以及添加自定义类(用于扩展 WebPartTransformer 类供 Web 部件连接使用)。

personalization

指定 Web 部件个性化设置提供程序,并设置 Web 部件个性化设置授权。

备注

默认配置

下面的默认 providers 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。

<providers>
  <add connectionStringName="LocalSqlServer"
    name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider, 
    System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</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

请参见

任务

如何:使用位置设置配置特定目录

如何:锁定 ASP.NET 配置设置

概念

ASP.NET 配置概述

ASP.NET 配置方案

保证 ASP.NET 配置的安全

参考

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

webParts 的 providers 的 add 元素(ASP.NET 设置架构)

webParts 的 providers 的 clear 元素(ASP.NET 设置架构)

webParts 的 providers 的 remove 元素(ASP.NET 设置架构)

WebPartsSection

WebPartsPersonalization

System.Configuration

System.Web.Configuration

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

管理 ASP.NET 网站

ASP.NET 配置 API