TransformerInfo クラス

.NET Framework クラス ライブラリ リファレンス

TransformerInfo クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Web パーツ接続に使用される WebPartTransformer クラスを拡張するカスタム クラスを指定します。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TransformerInfo
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As TransformerInfo

C#

public sealed class TransformerInfo : ConfigurationElement

C++

public ref class TransformerInfo sealed : public
 ConfigurationElement

J#

public final class TransformerInfo extends
 ConfigurationElement

JScript

public final class TransformerInfo extends
 ConfigurationElement

解説

TransformerInfo オブジェクトは、WebPartTransformer クラスを拡張するカスタム クラスを指定します。このカスタム トランスフォーマ クラスは、Web パーツ間のブリッジとしての役割を果たし、コネクション ポイントが互換性のない Web パーツ間でのデータ変換を行います。

使用例

以下は構成ファイルからの抜粋です。TransformerInfo クラスの複数のプロパティに対して、宣言によって値を指定する方法を示しています。

<system.web>
  <webParts>
    <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>
  </webParts> 
</system.web>

TransformerInfo クラスを使用するコード例を次に示します。このコード例は、WebPartsSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Add a Transfomer Info Object to the collection using a constructor.
webPartsSection.Transformers.Add(New TransformerInfo( _
  "RowToFilterTransformer", _
  "MyCustomTransformers.RowToFilterTransformer"))

' Show all TransformerInfo objects in the collection.
Dim ti As Integer
For ti = 0 To webPartsSection.Personalization.Providers.Count
 - 1
  Console.WriteLine("  #{0} Name={1} Type={2}", ti,
 _
    webPartsSection.Transformers(ti).Name, _
    webPartsSection.Transformers(ti).Type)
Next

' Remove a TransformerInfo object by name.
webPartsSection.Transformers.Remove("RowToFilterTransformer")

' Remove a TransformerInfo object by index.
webPartsSection.Transformers.RemoveAt(0)

' Clear all TransformerInfo objects from the collection.
webPartsSection.Transformers.Clear()

C#

// Add a Transfomer Info Object to the collection using a constructor.
webPartsSection.Transformers.Add(new TransformerInfo(
    "RowToFilterTransformer",
    "MyCustomTransformers.RowToFilterTransformer"));

// Show all TransformerInfo objects in the collection.
for (int ti = 0;
    ti < webPartsSection.Personalization.Providers.Count; ti++)
{
    Console.WriteLine("  #{0} Name={1} Type={2}", ti,
        webPartsSection.Transformers[ti].Name,
        webPartsSection.Transformers[ti].Type);
}

// Remove a TransformerInfo object by name.
webPartsSection.Transformers.Remove("RowToFilterTransformer");

// Remove a TransformerInfo object by index.
webPartsSection.Transformers.RemoveAt(0);

// Clear all TransformerInfo objects from the collection.
webPartsSection.Transformers.Clear();

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.TransformerInfo

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransformerInfo メンバ
System.Web.Configuration 名前空間
ConfigurationSection
WebPartsSection
WebPartTransformer
その他の技術情報
webParts 要素 (ASP.NET 設定スキーマ)
webParts の transformers 要素 (ASP.NET 設定スキーマ)
Web パーツ接続の概要