XslCompiledTransform

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

XslCompiledTransform クラス

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

XSLT スタイル シートを使用して、XML データを変換します。

名前空間: System.Xml.Xsl
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 XslCompiledTransform

Visual Basic (使用法)

Dim instance As XslCompiledTransform

C#

public sealed class XslCompiledTransform

C++

public ref class XslCompiledTransform sealed

J#

public final class XslCompiledTransform

JScript

public final class XslCompiledTransform

解説

XslCompiledTransform クラスは、XSLT 1.0 構文をサポートする XSLT プロセッサです。これは新しく実装されたクラスで、使用されなくなった XslTransform クラスに比べパフォーマンスが向上しています。XslCompiledTransform クラスの構造は、XslTransform クラスに非常によく似ています。Transform メソッドが XSLT の変換を実行するのに対し、Load メソッドはスタイル シートを読み込んでコンパイルします。

XSLT の document() 関数と埋め込みスクリプト ブロックのサポートは既定で無効になっています。XsltSettings オブジェクトを作成し、それを Load メソッドに渡すと、これらの機能を有効にできます。

詳細については、XslCompiledTransform クラスの使用、XslTransform クラスからの移行 の各トピックを参照してください。

セキュリティについての考慮事項

XslCompiledTransform クラスを使用するアプリケーションを作成する場合は、次の項目とその影響に注意してください。

• 既定では、XSLT スクリプトが無効にされています。どうしてもスクリプトをサポートする必要がある場合、または、完全に信頼された環境で使用する場合を除き、XSLT スクリプトは有効にしないでください。

• 既定では、XSLT の document() 関数が無効にされています。document() 関数を有効にした場合は、XmlSecureResolver オブジェクトを Transform メソッドに渡すことによって、アクセス可能なリソースを制限してください。

• 拡張機能オブジェクトは既定で有効になっています。拡張機能オブジェクトは、それを格納している XsltArgumentList オブジェクトが Transform メソッドに渡されると使用されます。

• XSLT スタイル シートには、他のファイルへの参照および埋め込みスクリプト ブロックを含めることができます。悪意のあるユーザーがこれを利用して、実行するとシステムでの処理によってコンピュータのリソースの低下を招くようなデータまたはスタイル シートを含める可能性があります。

• 信頼レベルが一定ではない環境で XSLT アプリケーションを実行する場合、スタイル シートがすり替えられる可能性があります。たとえば、悪意のあるユーザーが有害なスタイル シートを使ってオブジェクトを読み込み、それを別のユーザーに送ると、それを受け取ったユーザーが Transform メソッドを呼び出して変換を実行する可能性があります。

これらのセキュリティに関する問題は、信頼関係のないソースから取得したスタイル シートの場合はスクリプトまたは document() 関数を無効のままにしたり、信頼関係のないソースからの XslCompiledTransform オブジェクト、XSLT スタイル シート、および XML ソース データを受け入れないようにしたりすることで軽減できます。

使用例

変換を実行して、その結果をファイルに出力する例を次に示します。

Visual Basic

' Load the style sheet.
Dim xslt As New XslCompiledTransform()
xslt.Load("output.xsl")
        
' Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html")

C#

// Load the style sheet.
XslCompiledTransform xslt = new XslCompiledTransform();
xslt.Load("output.xsl");

// Execute the transform and output the results to a file.
xslt.Transform("books.xml", "books.html");

継承階層

System.Object
  System.Xml.Xsl.XslCompiledTransform

スレッド セーフ

XslCompiledTransform オブジェクトは、読み込まれるとスレッド セーフになります。つまり、Load メソッドが正常に完了すると、複数のスレッドから Transform メソッドを同時に呼び出すことができます。

Transform メソッドが、あるスレッドで呼び出されているときに、別のスレッドで Load メソッドがもう一度呼び出されると、XslCompiledTransform オブジェクトは古い状態の使用を継続することにより、Transform 呼び出しの実行を終了します。Load メソッドが正常に完了すると、新しい状態が使用されます。

メモ
Load メソッドを複数のスレッドから同時に呼び出すと、スレッド セーフになりません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
XslCompiledTransform メンバ
System.Xml.Xsl 名前空間
XsltArgumentList
XsltMessageEncounteredEventArgs
その他の技術情報
XSLT 変換
XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XslCompiledTransform コンストラクタ ()

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

XslCompiledTransform クラスの新しいインスタンスを初期化します。

名前空間: System.Xml.Xsl
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New XslCompiledTransform

C#

public XslCompiledTransform ()

C++

public:
XslCompiledTransform ()

J#

public XslCompiledTransform ()

JScript

public function XslCompiledTransform ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
XslCompiledTransform クラス
XslCompiledTransform メンバ
System.Xml.Xsl 名前空間
その他の技術情報
XslCompiledTransform クラスの使用
XslCompiledTransform クラスの使用

XslCompiledTransform コンストラクタ (Boolean)

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

XslCompiledTransform クラスの新しいインスタンスを、指定されたデバッグ設定を使用して初期化します。

名前空間: System.Xml.Xsl
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    enableDebug As Boolean _
)

Visual Basic (使用法)

Dim enableDebug As Boolean

Dim instance As New XslCompiledTransform(enableDebug)

C#

public XslCompiledTransform (
    bool enableDebug
)

C++

public:
XslCompiledTransform (
    bool enableDebug
)

J#

public XslCompiledTransform (
    boolean enableDebug
)

JScript

public function XslCompiledTransform (
    enableDebug : boolean
)

パラメータ

enableDebug

デバッグ情報を生成する場合は true。それ以外の場合は false。これを true に設定すると、Microsoft Visual Studio デバッガを使用してスタイル シートをデバッグできます。

解説

コードにステップ インしてスタイル シートをデバッグするには、次の条件を満たす必要があります。

• enableDebug パラメータを true に設定します。

• スタイル シートは、Load メソッドに URI として渡すか、IXmlLineInfo インターフェイスを実装する XmlReader クラスの実装として渡します。IXmlLineInfo インターフェイスは、すべてのテキスト解析 XmlReader オブジェクトで実装されます。

  つまり、XmlDocument や XPathDocument などの IXPathNavigable オブジェクト、または IXmlLineInfo インターフェイスの実装されていない XmlReader の実装を使用してスタイル シートを読み込むと、スタイル シートをデバッグできません。

• スタイル シートを読み込むために使用する XmlResolver は、XmlUrlResolver (XslCompiledTransform クラスで使用される既定の XmlResolver) などの、ファイル ベースの XmlResolver にします。

• ローカル コンピュータ上またはイントラネット上にスタイル シートを配置します。

使用例

XSLT のデバッグを有効にする方法の例を次に示します。

Visual Basic

' Enable XSLT debugging.
Dim xslt As New XslCompiledTransform(true)

' Load the style sheet.
xslt.Load("output.xsl")

' Create the writer.
Dim settings As New XmlWriterSettings()
settings.Indent=true
Dim writer As XmlWriter = XmlWriter.Create("output.xml",
 settings)

' Execute the transformation.
xslt.Transform("books.xml", writer)
writer.Close()

C#

// Enable XSLT debugging.
XslCompiledTransform xslt = new XslCompiledTransform(true);

// Load the style sheet.
xslt.Load("output.xsl");

// Create the writer.
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent=true;
XmlWriter writer = XmlWriter.Create("output.xml", settings);

// Execute the transformation.
xslt.Transform("books.xml", writer);
writer.Close();

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
XslCompiledTransform クラス
XslCompiledTransform メンバ
System.Xml.Xsl 名前空間
その他の技術情報
XslCompiledTransform クラスの使用

XslCompiledTransform コンストラクタ

XslCompiledTransform クラスの新しいインスタンスを初期化します。 XslCompiledTransform クラスの使用
オーバーロードの一覧

名前	説明
XslCompiledTransform ()	XslCompiledTransform クラスの新しいインスタンスを初期化します。
XslCompiledTransform (Boolean)	XslCompiledTransform クラスの新しいインスタンスを、指定されたデバッグ設定を使用して初期化します。

参照

関連項目

XslCompiledTransform クラス
XslCompiledTransform メンバ
System.Xml.Xsl 名前空間

その他の技術情報

XslCompiledTransform クラスの使用
XslCompiledTransform クラスの使用

XslCompiledTransform プロパティ

パブリック プロパティ

	名前	説明
	OutputSettings	スタイル シートの xsl:output 要素から派生した出力情報が格納された XmlWriterSettings オブジェクトを取得します。
	TemporaryFiles	Load メソッドの呼び出しが正常に完了した後でディスク上に作成される一時ファイルが格納された TempFileCollection を取得します。

参照

関連項目

XslCompiledTransform クラス
System.Xml.Xsl 名前空間
XsltArgumentList
XsltMessageEncounteredEventArgs

その他の技術情報

XSLT 変換
XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XslCompiledTransform メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Load	オーバーロードされます。 スタイル シートをコンパイルします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Transform	オーバーロードされます。 XSLT 変換を実行します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

XslCompiledTransform クラス
System.Xml.Xsl 名前空間
XsltArgumentList
XsltMessageEncounteredEventArgs

その他の技術情報

XSLT 変換
XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション

XslCompiledTransform メンバ

XSLT スタイル シートを使用して、XML データを変換します。

XslCompiledTransform データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	XslCompiledTransform	オーバーロードされます。 XslCompiledTransform クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	OutputSettings	スタイル シートの xsl:output 要素から派生した出力情報が格納された XmlWriterSettings オブジェクトを取得します。
	TemporaryFiles	Load メソッドの呼び出しが正常に完了した後でディスク上に作成される一時ファイルが格納された TempFileCollection を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Load	オーバーロードされます。 スタイル シートをコンパイルします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Transform	オーバーロードされます。 XSLT 変換を実行します。

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

XslCompiledTransform クラス
System.Xml.Xsl 名前空間
XsltArgumentList
XsltMessageEncounteredEventArgs

その他の技術情報

XSLT 変換
XML ドキュメントと XML データ
セキュリティと System.Xml アプリケーション