使用 TextTransform 公用程式產生檔案

更新：2010 年 6 月

TextTransform.exe 是可用於轉換文字範本的命令列工具。 當您呼叫 TextTransform.exe 時，您會指定文字範本檔案的名稱做為引數。 TextTransform.exe 會呼叫文字轉換引擎並處理文字範本。 TextTransform.exe 通常是從指令碼呼叫。

注意事項
如果要在建置程序中執行文字轉換，請考慮使用 MSBuild 文字轉換工作。 如需詳細資訊，請參閱建置流程中的程式碼產生。 在已安裝 Visual Studio 的電腦中，您也可以撰寫能夠轉換文字範本的應用程式或 Visual Studio。 如需詳細資訊，請參閱使用自訂主機處理文字範本。

TextTransform.exe 位於下列目錄：

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.0

TextTransform [<options>] <templateName>

參數

引數	描述
templateName	識別您想要轉換之範本檔案的名稱。

選項	描述
-out <檔案名稱>	轉換輸出所寫入的檔案。
-r <組件>	用來編譯及執行文字範本的組件。
-u <命名空間>	用於編譯範本的命名空間。
-I <includedirectory>	含有包含在指定文字範本中的文字範本的目錄。
-P <參考路徑>	要搜尋在文字範本內指定的組件或使用 -r 選項的目錄。 例如，若要包括 Visual Studio API 所使用的組件，請使用 -P"%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp <處理器名稱>!<類別名稱>!<組件名稱|程式碼基底>	指示詞處理器的名稱、完整型別名稱和組件，此處理器可用於處理文件範本內的自訂指示詞。
-a [處理器名稱]![指示詞名稱]!<參數名稱>!<參數值> 警告 務必輸入 '！' 標記，即使您省略選擇性處理器和指示詞名稱。例如： -a !!param!value	指定指示詞處理器的參數值。 如果只指定參數的名稱和值，所有指示詞處理器都能使用該參數。 如果您指定指示詞處理器，則只有指定的處理器能夠使用參數。 如果您指定指示詞名稱，則必須在處理指定的指示詞後才能使用參數。 若要存取指示詞處理器或文字範本中的參數值，請使用 ResolveParameterValue(String, String, String)。 在文字範本中，將 hostspecific 包含在範本指定詞中，並叫用 this.Host 上的訊息。 例如： <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]
-h	提供說明。

相關主題

工作	主題
在 Visual Studio 方案中產生檔案。	使用 T4 文字範本在設計階段產生程式碼
撰寫指示詞處理器來轉換自己的資料來源。	自訂 T4 文字轉換
寫入文字樣板化主機，可讓您從自己的應用程式叫用文字範本。	使用自訂主機處理文字範本

變更記錄

日期	記錄	原因
2010 年 6 月	已加入有關 –a 選項的資訊。	客戶回函。