使用 TextTransform 公用程式產生檔案
如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。
TextTransform.exe 是命令列工具可讓您轉換文字範本。 當您呼叫 TextTransform.exe 時，您可以指定文字範本檔案的名稱做為引數。 TextTransform.exe 呼叫文字轉換引擎，並處理文字範本。 TextTransform.exe 通常會從指令碼呼叫。 不過，它通常是必要的因為不在 Visual Studio 或在建置流程中，您可以執行文字轉換。
注意
如果您想要執行文字轉換為建置流程的一部分，請考慮使用 MSBuild 文字轉換工作。 如需詳細資訊，請參閱 建置流程中的程式碼產生。 中的電腦上 Visual Studio 安裝時，您也可以撰寫應用程式或 Visual Studio 可以轉換文字範本的副檔名。 如需詳細資訊，請參閱 使用自訂主機處理文字範本。
TextTransform.exe 位於下列目錄︰
\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0
語法
TextTransform [<options>] <templateName>
參數
| 引數 | 說明 |
|---|---|
templateName |
識別您想要轉換的範本檔案的名稱。 |
| 選項 | 說明 |
|---|---|
| -out < 檔案名稱> | 轉換的輸出寫入檔案。 |
| -r < 組件> | 用來編譯及執行文字範本組件。 |
| -u < 命名空間> | 用於編譯範本命名空間。 |
| -I < includedirectory> | 包含指定的文字範本中所包含的文字範本的目錄。 |
| -P < 重新整理路徑> | 要搜尋的文字範本中指定的組件，或使用的目錄 -r 選項。 例如，若要包含 Visual Studio API 所使用的組件，使用 -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies" |
| -dp < processorName>！ < className>！ < assemblyName | 程式碼基底 > | 名稱、 完整的型別名稱和組件可以用來處理文字範本內的自訂指示詞的指示詞處理器。 |
| -a [processorName] ！ [directiveName] ！ < parameterName>！ < parameterValue> | 指定參數值，指示詞處理器。 如果您指定參數名稱和值，此參數可指示詞的所有處理器。 如果您指定指示詞處理器，參數是僅適用於指定的處理器。 如果您指定指示詞的名稱，參數只能指定指示詞在處理時，才會出現。 若要存取的參數值，指示詞處理器或文字範本中，使用 ResolveParameterValue。 在文字範本中，包括 hostspecific 在範本指示詞上叫用的訊息和 this.Host。 例如:<#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>].一律使用類型 '！' 標示，即使您省略選擇性的處理器和指示詞的名稱。 例如: -a !!param!value |
| -h | 提供說明。 |
相關主題
| 工作 | 主題 |
|---|---|
| 在 Visual Studio 方案中產生檔案。 | 使用 T4 文字範本的設計階段程式碼產生 |
| 撰寫指示詞處理器，以轉換您專屬的資料來源。 | 自訂 T4 文字轉換 |
| 撰寫文字範本化主應用程式，可讓您叫用您自己的應用程式從文字範本。 | 使用自訂主機處理文字範本 |