TextTransform.exe 是命令列工具，可用來轉換文字範本。 當您呼叫 TextTransform.exe時，您可以指定文字範本檔案的名稱作為引數。 TextTransform.exe 會呼叫文字轉換引擎並處理文字範本。 TextTransform.exe 通常從腳本呼叫。 不過，通常不需要，因為您可以在 Visual Studio 或建置程式中執行文字轉換。
備註
如果您想要在建置程式中執行文字轉換，請考慮使用 MSBuild 文字轉換工作。 如需詳細資訊，請參閱 建置程式中的程式代碼產生。 在安裝 Visual Studio 的電腦中，您也可以撰寫可轉換文字範本的應用程式或 Visual Studio 延伸模組。 如需詳細資訊，請參閱 使用自訂主機處理文字範本。
TextTransform.exe 位於下列目錄中：
\Program Files （x86）\Microsoft Visual Studio\2019\Professional\Common7\IDE
專業版，或
\Program Files （x86）\Microsoft Visual Studio\2019\Enterprise\Common7\IDE
適用於企業版。
\程式檔案\Microsoft Visual Studio\2022\Professional\Common7\IDE
專業版，或
\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE
適用於企業版。
語法
TextTransform [<options>] <templateName>
參數
| 引數 | 說明 |
|---|---|
templateName |
識別您要轉換的範本檔案名稱。 |
| 選項 | 說明 |
|---|---|
| -out<檔案名稱> | 將轉換輸出寫入的檔案。 |
| -r<組件> | 用來編譯和執行文字範本的組件。 |
| -u<命名空間> | 用來編譯範本的命名空間。 |
| -I<include 目錄> | 包含指定文字範本中包含的文字範本的目錄。 |
| -P<參考路徑> | 用於搜尋文字範本內指定的元件或使用 -r 選項的目錄。 例如，若要包含用於 Visual Studio API 的元件，請使用 -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies" |
| -DP<processorName>！<類別名稱>！<assemblyName|程式碼庫> | 指令處理器名稱、完整的類型名稱和組件，用於處理範本文本中的自訂指令。 |
| -a [處理器名稱]！[指令名稱]！<參數名稱>！<參數值> | 指定指引處理器的參數值。 如果您只指定參數名稱和值，則所有指引處理器都可以使用該參數。 如果您指定指引處理器，則參數僅可供指定的處理器使用。 如果您指定指引名稱，則只有在處理指定的指引時，才能使用參數。 若要從指示詞處理器或文字範本存取參數值，請使用 ITextTemplatingEngineHost.ResolveParameterValue。 在文字範本中，包括 hostspecific在範本指令中，並在this.Host上呼叫消息。 例如：<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]。一律鍵入 '！' 標記，即使您省略選用的處理器和指令名稱也一樣。 例如： -a !!param!value |
| -h | 提供幫助。 |