TextTransform.exe は、テキスト テンプレートの変換に使用できるコマンドライン ツールです。 TextTransform.exeを呼び出すときは、テキスト テンプレート ファイルの名前を引数として指定します。 TextTransform.exe テキスト変換エンジンを呼び出し、テキスト テンプレートを処理します。 TextTransform.exe は通常、スクリプトから呼び出されます。 ただし、Visual Studio またはビルド プロセスでテキスト変換を実行できるため、通常は必須ではありません。
注
ビルド プロセスの一部としてテキスト変換を実行する場合は、MSBuild テキスト変換タスクの使用を検討してください。 詳細については、「 ビルド プロセスでのコード生成」を参照してください。 Visual Studio がインストールされているコンピューターでは、テキスト テンプレートを変換できるアプリケーションまたは Visual Studio 拡張機能を記述することもできます。 詳細については、「 カスタム ホストを使用したテキスト テンプレートの処理」を参照してください。
TextTransform.exe は次のディレクトリにあります。
構文
TextTransform [<options>] <templateName>
パラメーター
| 引数 | 説明 |
|---|---|
templateName |
変換するテンプレート ファイルの名前を識別します。 |
| オプション | 説明 |
|---|---|
| -out<filename> | 変換の出力の書き込み先となるファイル。 |
| -r<アセンブリ> | テキスト テンプレートのコンパイルと実行に使用されるアセンブリ。 |
| -u<名前空間> | テンプレートのコンパイルに使用される名前空間。 |
| -I<includedirectory> | 指定したテキスト テンプレートに含まれるテキスト テンプレートを含むディレクトリ。 |
| -P<参照パス> | テキスト テンプレート内または -r オプションを使用して指定されたアセンブリを検索するディレクトリ。 たとえば、Visual Studio API に使用されるアセンブリを含めるには、 -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies" |
| -dp<processorName>!<className>!<assemblyName|codeBase> | テキスト テンプレート内でカスタム ディレクティブを処理するために使用できるディレクティブ プロセッサの名前、完全な型名、およびアセンブリ。 |
| -a [processorName]![directiveName]!<parameterName>!<parameterValue> | ディレクティブ プロセッサのパラメーター値を指定します。 パラメーターの名前と値のみを指定した場合、パラメーターはすべてのディレクティブ プロセッサで使用できます。 ディレクティブ プロセッサを指定した場合、パラメーターは指定されたプロセッサでのみ使用できます。 ディレクティブ名を指定した場合、パラメーターは、指定したディレクティブが処理されている場合にのみ使用できます。 ディレクティブ プロセッサまたはテキスト テンプレートからパラメーター値にアクセスするには、 ITextTemplatingEngineHost.ResolveParameterValue を使用します。 テキスト テンプレートで、テンプレート ディレクティブに hostspecific を含め、 this.Hostでメッセージを呼び出します。 例えば次が挙げられます。<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]。省略可能なプロセッサ名とディレクティブ名を省略した場合でも、必ず '!' マークを入力してください。 例えば次が挙げられます。 -a !!param!value |
| -h | ヘルプを提供します。 |