T4 輸出指示詞

在 Visual Studio 文字範本中，output 指示詞可用來定義轉換之檔案的副檔名和編碼。

例如，如果 Visual Studio 專案有一個名為 MyTemplate.tt 的範本檔，其中包含下列指示詞：

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

則 Visual Studio 會產生一個名為 MyTemplate.cs 的檔案

在執行階段 (前置處理過的) 文字範本中，不需要 output 指示詞。而是，應用程式會呼叫 TextTransform() 來取得產生的字串。如需詳細資訊，請參閱使用 T4 文字範本在執行階段產生文字。

使用輸出指示詞

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

每個文字範本中的 output 指示詞不得超過一個。

extension 屬性

指定產生之文字輸出檔的副檔名。

預設值為 .cs。

• 例如：
  <#@ output extension=".txt" #>

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

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

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

• 可接受的值：
  任何有效的副檔名。

encoding 屬性

指定產生輸出檔時要使用的編碼方式。例如：

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

預設值為文字範本檔所使用的編碼。

• 可接受的值：
  us-ascii

  utf-16BE

  utf-16

  utf-8

  utf-7

  utf-32

  0 (系統預設)

  通常，您可以使用 Encoding.GetEncoding 所傳回之任何編碼的 WebName 字串或 CodePage 編號。