Export (0) Print
Expand All

transformers Element for webParts (ASP.NET Settings Schema)

Defines a collection of TransformerInfo objects.


<transformers>
    <add.../>
    <clear />
    <remove.../>
</transformers>

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element Description

add

Optional String element.

Adds a Transformers object to the collection.

clear

Optional String element.

Removes all transformers objects from the collection.

remove

Optional String element.

Removes the specified transformers object from the collection.

Parent Elements

Element Description

configuration

The required root element in every configuration file used by the common language runtime and .NET Framework applications.

system.web

Specifies the root element for the ASP.NET configuration settings in a configuration file. Contains configuration elements that configure ASP.NET Web applications and control how the applications behave.

webParts

Allows you to specify a Web Parts personalization provider, set personalization authorizations, and add custom classes that extend the Transformer class for use by Web Parts connections.

The transformers specified in configuration are the transformers used when determining compatibility for a potential dynamic connection. Also, the only transformers that can be used on a page, statically or dynamically, are the transformers specified in configuration.

The following default transformers element is configured in the root Web.config file in the .NET Framework version 2.0.

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

The following example configures transformers for an ASP.NET application.

<webParts>
  <transformers>
    <clear />
      <remove name="RowToKeysTransformer" />
      <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>
</webParts>

Configuration Section Handler

System.Web.Configuration.WebPartsSection

Configuration Member

System.Web.Configuration.WebPartsSection.Transformers

Configurable Locations

Machine.config

Root-level Web.config

Application-level Web.config

Virtual or physical directory level Web.config

Requirements

IIS 6.0

.NET Framework 2.0

Visual Studio 2005

Community Additions

ADD
Show:
© 2014 Microsoft