XSLT コンパイラ (xsltc.exe)
XSLT コンパイラ (xsltc.exe) は、XSLT スタイル シートをコンパイルしてアセンブリを生成します。 コンパイルしたスタイル シートを XslCompiledTransform.Load(Type) メソッドに直接渡すことができます。 xsltc.exe を使用して署名があるアセンブリを生成することはできません。
注意
スクリプト ブロックは、.NET Framework でのみサポートされています。 .NET Core または .NET 5 以降ではサポートされて "いません"。
xsltc.exe ツールは Visual Studio に付属しています。 詳細については、Visual Studio のダウンロードを参照してください。
構文
xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]
引数
| Argument | 説明 |
|---|---|
sourceFile |
スタイル シートの名前を指定します。 スタイル シートはローカル ファイルであるか、イントラネット上に置かれていることが必要です。 |
オプション
| オプション | 説明 |
|---|---|
/c[lass]: name |
以降のスタイル シートのクラス名を指定します。 クラス名には完全修飾名を指定できます。 既定のクラス名は、スタイル シートの名前です。 たとえば、スタイル シート customers.xsl をコンパイルした場合、既定のクラス名は customers になります。 |
/debug[+|-] |
デバッグ情報を生成するかどうかを指定します。+ または /debug を指定すると、コンパイラによりデバッグ情報が生成され、プログラム データベース (PDB) ファイルに記録されます。 生成される PDB ファイルの名前は assemblyName.pdb です。- を指定すると、実質的に /debug を指定しないことになり、デバッグ情報は作成されません。 製品版のアセンブリが生成されます。 注: デバッグ モードでコンパイルすると、XSLT のパフォーマンスが大きな影響を受けることがあります。 |
/help |
このツールのコマンド構文とオプションを表示します。 |
/nologo |
コンパイラの著作権メッセージが表示されないようにします。 |
/platform: string |
アセンブリを実行できるプラットフォームを指定します。 次に、有効なプラットフォームの値を示します。x86 : 32 ビット x86 互換共通言語ランタイムにより実行できるように、アセンブリをコンパイルします。x64 : AMD64 または EM64T 命令セットをサポートするコンピューターで 64 ビット共通言語ランタイムにより実行できるように、アセンブリをコンパイルしますItanium は、Itanium プロセッサを搭載したコンピューターで 64 ビット共通言語ランタイムにより実行できるように、アセンブリをコンパイルします。 anycpu : 任意のプラットフォーム上で実行できるように、アセンブリをコンパイルします。 既定値です。 |
/out: assemblyName |
出力となるアセンブリの名前を指定します。 複数のスタイル シートが存在している場合、既定のアセンブリ名はメインのスタイル シートか最初のスタイル シートの名前になります。 スタイル シートにスクリプトが含まれている場合、スクリプトは別のアセンブリに保存されます。 スクリプト アセンブリ名は、メインのアセンブリ名から生成されます。 たとえば、アセンブリ名を CustOrders.dll と指定した場合、最初のスクリプト アセンブリは CustOrders_Script1.dll という名前になります。 |
/settings: document+-, script+-, DTD+-, |
スタイル シートで document() 関数、XSLT スクリプト、またはドキュメント型定義 (DTD) を許可するかどうかを指定します。既定では、DTD、 document() 関数、スクリプトのサポートは無効になっています。 |
@ file |
コンパイラ オプションを含むファイルを指定できます。 |
? |
このツールのコマンド構文とオプションを表示します。 |
Remarks
XSLT ソリューションは、複数のスタイル シート モジュールで構成できます。 xsltc.exe ツールを使用して、スタイル シートからアセンブリを生成できます。 このアセンブリを XslCompiledTransform.Load(Type) メソッドに直接渡すことができます。 XSLT の配置シナリオによっては、これによってパフォーマンス コストを削減できます。
注意
アプリケーションには、コンパイル済みのアセンブリも参照として含める必要があります。
xsltc.exe ツールでは、クラス名 (/class:name) やアセンブリ名 (/out:assemblyName) が検証されません。 名前が無効である場合、共通言語ランタイムによってエラーがスローされます。
使用例
次のコマンドを実行すると、スタイル シートがコンパイルされ、booksort.dll という名前のアセンブリが作成されます。
xsltc booksort.xsl
次のコマンドを実行すると、スタイル シートがコンパイルされ、booksort.dll という名前のアセンブリと booksort.pdb という名前の PDB ファイルが作成されます。
xsltc booksort.xsl /debug
次のコマンドを実行すると、msxsl:script 要素を含むスタイル シートがコンパイルされ、calc.dll と calc_Script1.dll という 2 つのアセンブリが作成されます。
xsltc /settings:script+ calc.xsl
次のコマンドを実行すると、DTD 処理とスタイルのサポートが有効になり、myTest.dll および myTest_Script1.dll という 2 つのアセンブリが作成されます。
xsltc /settings:DTD+,script+ /out:myTest calc.xsl
次のコマンドを実行すると、2 つのスタイル シート モジュールがコンパイルされ、booksort.dll という名前のアセンブリが 1 つ作成されます。
xsltc booksort.xsl output.xsl
関連項目
.NET