Gerar arquivos com o utilitário TextTransform

TextTransform.exe é uma ferramenta de linha de comando que você pode usar para transformar um modelo de texto. Ao chamar TextTransform.exe, especifique o nome de um arquivo de modelo de texto como um argumento. TextTransform.exe chama o mecanismo de transformação de texto e processa o modelo de texto. TextTransform.exe geralmente é chamado por scripts. No entanto, geralmente não é necessário, pois você pode executar a transformação de texto no Visual Studio ou no processo de build.

Observação

Se você quiser executar a transformação de texto como parte de um processo de build, considere usar a tarefa de transformação de texto do MSBuild. Para obter mais informações, consulte a Geração de Código em um processo de build. Em um computador no qual o Visual Studio está instalado, você também pode escrever um aplicativo ou uma extensão do Visual Studio que pode transformar modelos de texto. Para obter mais informações, consulte Processando modelos de texto usando um host personalizado.

TextTransform.exe está localizado no seguinte diretório:

\Arquivos de Programas\Microsoft Visual Studio\2022\Professional\Common7\IDE

para a edição Professional ou

\Arquivos de Programas\Microsoft Visual Studio\2022\Enterprise\Common7\IDE

para a edição Enterprise.

Sintaxe

TextTransform [<options>] <templateName>

Parâmetros

Argumento	Descrição
templateName	Identifica o nome do arquivo de modelo que você deseja transformar.

Opção	Descrição
-out<nome_do_arquivo>	O arquivo no qual a saída da transformação é gravada.
-r<assembly>	Um assembly usado para compilar e executar o modelo de texto.
-u<namespace>	Um namespace usado para compilar o modelo.
-I<includedirectory>	Um diretório que contém os modelos de texto incluídos no modelo de texto especificado.
-P<referencepath>	Um diretório para pesquisar assemblies especificados no modelo de texto ou para usar a opção -r . Por exemplo, para incluir assemblies usados para a API do Visual Studio, use -P "%VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp<processorName>!<className>!<assemblyName|codeBase>	O nome, o nome do tipo completo e o assembly de um processador de diretiva que pode ser usado para processar diretivas personalizadas dentro do modelo de texto.
-a [processorName]![directiveName]!<parameterName>!<parameterValue>	Especifique um valor de parâmetro para um processador de diretiva. Se você especificar apenas o nome e o valor do parâmetro, o parâmetro estará disponível para todos os processadores de diretiva. Se você especificar um processador de diretiva, o parâmetro estará disponível apenas para o processador especificado. Se você especificar um nome de diretiva, o parâmetro estará disponível somente quando a diretiva especificada estiver sendo processada. Para acessar os valores de parâmetro de um processador de diretiva ou modelo de texto, use ITextTemplatingEngineHost.ResolveParameterValue. Em um modelo de texto, inclua hostspecific na diretiva de modelo e invoque a mensagem em this.Host. Por exemplo: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]. Sempre digite o sinal '!' mesmo que você omita os nomes opcionais de processador e diretiva. Por exemplo: -a !!param!value
-h	Fornece ajuda.

Conteúdo relacionado

• Geração de código em tempo de design usando modelos de texto T4
• Personalizando a transformação de texto T4
• Processando modelos de texto usando um host personalizado