T4 出力ディレクティブ

  • [アーティクル]

Visual Studio テキスト テンプレートでは、output ディレクティブを使用してファイル名の拡張子と変換ファイルのエンコードを定義します。

たとえば、Visual Studio プロジェクトに含まれている MyTemplate.tt という名前のテンプレート ファイルに次のディレクティブが含まれているとします。

<#@output extension=".cs"#>

その場合、Visual Studio によって MyTemplate.cs という名前のファイルが生成されます。

output ディレクティブは、実行時 (前処理済み) のテキスト テンプレートには必要ありません。 その代わりに、アプリケーションは TextTransform() を呼び出して、生成済みの文字列を取得します。 詳細については、「T4 テキスト テンプレートを使用した実行時テキスト生成」を参照してください。

出力ディレクティブの使用

<#@ output extension=".fileNameExtension" [encoding="encoding"] #>

各テキスト テンプレートには複数の output ディレクティブを含めてはいけません。

拡張子属性

生成されたテキスト出力ファイルのファイル名の拡張子を指定します。

既定値は .cs です

例: <#@ output extension=".txt" #>

<#@ output extension=".htm" #>

<#@ output extension=".cs" #>

<#@ output extension=".vb" #>

許容される値: あらゆる有効なファイル名拡張子。

エンコード属性

出力ファイルが生成されるときに使用するエンコードを指定します。 たとえば次のような点です。

<#@ output encoding="utf-8"#>

既定値は、テキスト テンプレート ファイルが使用するエンコードです。

許容される値: us-ascii

utf-16BE

utf-16

utf-8

utf-7

utf-32

0 (システムの既定値)

一般に、System.Text.Encoding.GetEncodings が返す任意のエンコードの WebName 文字列または CodePage 数値を使用できます。