次の方法で共有


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

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

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

属性および要素

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

属性

なし。

子要素

要素

説明

add

省略可能な String 要素

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

clear

省略可能な String 要素

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

remove

省略可能な String 要素

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

親要素

要素

説明

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

参照

処理手順

方法 : Location の設定を使用して特定のディレクトリを構成する

方法 : ASP.NET 構成設定をロックする

参照

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 構成ファイルの階層と継承

ASP.NET 構成の保護

ASP.NET の構成のシナリオ

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

ASP.NET Web サイト管理

ASP.NET 構成ファイル

ASP.NET 構成 API