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

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

向集合添加一个 Transformers 对象。

<add name="String"
     type="String"/>

特性和元素

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

特性

特性

说明

name

必选的 String 特性。

为某种类型设置友好名称,该类型扩展了 TransformerInfo 类。

type

必选的 String 特性。

为某个类设置类型引用,该类扩展了 TransformerInfo 类。

子元素

无。

父元素

元素

说明

configuration

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

system.web

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

webParts

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

transformers

定义 TransformerInfo 对象的集合。

备注

默认配置

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

<transformers>
  <add name="RowToFieldTransformer" 
type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
  <add name="RowToParametersTransformer" 
type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
</transformers>

示例

下面的示例向集合中添加三个 transformers 对象。

<transformers>
  <add name="RowToFieldTransformer"
       type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
  <add name="RowToFilterTransformer"
       type="System.Web.UI.WebControls.WebParts.RowToFilterTransformer" />
  <add name="RowToParametersTransformer"
    type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
</transformers>

注意   集合不能已经包含具有相同的 name 属性值的 TransformerInfo 对象。

元素信息

Configuration Section Handler

System.Web.Configuration.WebPartsSection

Configuration Member

WebPartsSection.Transformers

Configurable Locations

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

虚拟或物理目录级别的 Web.config

Requirements

IIS 版本 6.0

.NET Framework 版本 2.0

Visual Studio 2005

请参见

任务

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

参考

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

configuration 元素(常规设置架构)

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

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

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

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

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API