使用 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

适用于 Professional 版或

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

适用于 Enterprise 版。

语法

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 文本转换
• 使用自定义宿主处理文本模板