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 號碼。