Share via


webParts の transformers 要素 (ASP.NET 設定スキーマ)

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

TransformerInfo オブジェクトのコレクションを定義します。

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

なし。

子要素

要素

Description

add

省略可能な String 要素

Transformers オブジェクトをコレクションに追加します。

clear

省略可能な String 要素

すべての transformers オブジェクトをコレクションから削除します。

remove

省略可能な String 要素

指定された transformers オブジェクトをコレクションから削除します。

親要素

要素

Description

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。

webParts

Web パーツ パーソナル化プロバイダーの指定やパーソナル化承認の設定ができる他、Web パーツの接続によって使用される Transformer クラスを拡張したカスタム クラスを追加できます。

解説

構成で指定されるトランスフォーマーは、実行しようとする動的接続の互換性を判断するときに使用されるトランスフォーマーです。 また、ページ上で使用できる唯一のトランスフォーマーは、静的接続か動的接続かに関係なく、構成で指定されたトランスフォーマーです。

既定の構成

次の既定の transformers 要素は、.NET Framework Version 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>

使用例

ASP.NET アプリケーションの transformers を構成する例を次に示します。

<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>

要素情報

構成セクション ハンドラー

System.Web.Configuration.WebPartsSection

構成メンバー

WebPartsSection.Transformers

構成できる場所

Machine.config

ルート レベルの Web.config

アプリケーション レベルの Web.config

仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config

要件

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

Reference

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

webParts 要素 (ASP.NET 設定スキーマ)

webParts の transformers の add 要素 (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