XslTransformation タスク

  • [アーティクル]

XSLT またはコンパイルされた XSLT を利用して XML 入力を変換し、出力デバイスまたはファイルに出力します。

パラメーター

XslTransformation タスクのパラメーターの説明を次の表に示します。

パラメーター 説明
OutputPaths 必須の ITaskItem[] 型のパラメーターです。

XML 変換の出力ファイルを指定します。
Parameters 省略可能な String 型のパラメーターです。

XSLT 入力ドキュメントにパラメーターを指定します。 各パラメーターを <Parameter Name="" Value="" Namespace="" /> として保持する未加工 XML が提供されます。
UseTrustedSettings 省略可能なブール値のパラメーターです。

True の場合、XSLT document() 関数および埋め込みスクリプトの使用を許可する厳格でない XSLT セキュリティ設定が有効になります。 以下を参照してください。TrustedXslt 関連するセキュリティに関する考慮事項については、「セキュリティに関する考慮事項」をご覧ください。
XmlContent 省略可能な String 型のパラメーターです。

XML 入力を文字列として指定します。
XmlInputPaths 省略可能な ITaskItem[] 型のパラメーターです。

XML 入力ファイルを指定します。
XslCompiledDllPath 省略可能な ITaskItem 型のパラメーターです。

コンパイルされた XSLT を指定します。
XslContent 省略可能な String 型のパラメーターです。

XSLT 入力を文字列として指定します。
XslInputPath 省略可能な ITaskItem 型のパラメーターです。

XSLT 入力ファイルを指定します。

解説

重要

XSLT スタイル シートには、他のファイルへの参照や埋め込みのスクリプト ブロックを含めることができます。 悪意のあるユーザーがこれを悪用して、コンピューターがリソース不足に陥るまでシステムに処理を行わせようとするデータやスタイル シートを提供する可能性があります。 スタイル シートが信頼できるソースから提供されたものである場合を除き、UseTrustedSettings を使ってスクリプトまたは document() 関数を有効にしないでください。 スタイル シートのソースを確認できない場合、またはスタイル シートが信頼できないソースのものである場合は、XSLT の既定の設定を使ってください。

また、スキーマなどの外部リソースを読み込むと、スキーマをホストするすべてのサーバーがビルドの発生とそのネットワークの場所を検出できます。

表に示されているパラメーターを使用できるだけでなく、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は Task クラスから継承されます。 これらの追加のパラメーターの一覧とその説明については、「TaskExtension Base Class」を参照してください。

例

次の例では、xml ファイル $(XmlInputFileName) の変更に XSL 変換ファイル transform.xslt が使用されます。 変換された XML は $(IntermediateOutputPath)output.xml に書き込まれます。 XSL 変換では入力パラメーターとして $(Parameter1) が受け取られます。

    <XslTransformation XslInputPath="transform.xslt"
                       XmlInputPaths="$(XmlInputFileName)"
                       OutputPaths="$(IntermediateOutputPath)output.xml"
                       Parameters="&lt;Parameter Name='Parameter1' Value='$(Parameter1)'/&gt;"/>

関連項目