使用 TextTransform 公用程式產生檔案

TextTransform.exe 是您可以用來轉換文字範本的命令列工具。。 呼叫 TextTransform.exe 時，您會將文字範本檔案的名稱指定為引數。 TextTransform.exe 會呼叫文字轉換引擎，並處理文字範本。 TextTransform.exe 通常是從指令碼呼叫。 不過，通常不需要進行此呼叫，因為您可以在 Visual Studio 或在建置流程中執行文字轉換。

注意

如果您想要在建置過程中執行文字轉換，請考慮使用 MSBuild 文字轉換工作。 如需詳細資訊，請參閱建置流程中的程式碼產生。 在已安裝 Visual Studio 的機器上，您也可以撰寫可轉換文字範本的應用程式或 Visual Studio 延伸模組。 如需詳細資訊，請參閱使用自訂主機處理文字範本。

TextTransform.exe 位於下列目錄中：

\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE

(適用於專業版)，或

\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

(適用於企業版)。

語法

TextTransform [<options>] <templateName>

參數

Argument	說明
templateName	識別您想要轉換的範本檔案名稱。

選項	說明
-out<filename>	寫入轉換輸出的檔案。
-r<assembly>	用於編譯和執行文字範本的組件。
-u<namespace>	用於編譯範本的命名空間。
-I<includedirectory>	目錄，其中包含所指定文字範本中包括的文字範本。
-P<referencepath>	目錄，用來搜尋文字範本內指定的元件，或使用 -r 選項進行搜尋。 例如，若要包含用於 Visual Studio API 的組件，請使用 -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	指示詞處理器的名稱、完整類型名稱和組件，此處理器可以用來處理文字範本內的自訂指示詞。
-a [processorName]![directiveName]!<parameterName>!<parameterValue>	指定指示詞處理器的參數值。 如果您只指定參數名稱和值，參數將可供所有指示詞處理器使用。 如果您指定指示詞處理器，則參數只供指定的處理器使用。 如果您指定指示詞名稱，僅在處理指定的指示詞時，才能使用參數。 若要從指示詞處理器或文字範本存取參數值，請使用 ITextTemplatingEngineHost.ResolveParameterValue。 在文字範本中，將 hostspecific 併入範本指示詞中，並在 this.Host 上叫用訊息。 例如： <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. 一律輸入 '!' 標記，即使您省略選用處理器和指示詞名稱也一樣。 例如： -a !!param!value
-h	提供說明。

相關內容

• 使用 T4 文字範本在設計階段產生程式碼
• 自訂 T4 文字轉換
• 使用自訂主機處理文字範本