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, você especifica 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 a partir de scripts. No entanto, geralmente não é necessário, porque você pode executar a transformação de texto no Visual Studio ou no processo de compilação.

Observação

Se você quiser executar a transformação de texto como parte de um processo de compilação, considere usar a tarefa de transformação de texto do MSBuild. Para obter mais informações, consulte Geração de código em um processo de compilação. Em uma máquina na qual o Visual Studio está instalado, você também pode escrever um aplicativo ou 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 ficheiro>	O arquivo no qual a saída da transformação é gravada.
-r<montagem>	Um assembly usado para compilar e executar o modelo de texto.
-u<namespace>	Um namespace que é usado para compilar o modelo.
-Eu<incluir diretório>	Um diretório que contém os modelos de texto incluídos no modelo de texto especificado.
-P<caminho de referência>	Um diretório para procurar 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 completo do tipo e a assemblagem de um processador de diretivas que pode ser usado para processar diretivas personalizadas no modelo de texto.
-a [processorName]! [directiveName]!<parameterName>!<valorparâmetro>	Especifique um valor de parâmetro para um processador de diretrizes. Se você especificar apenas o nome e o valor do parâmetro, o parâmetro estará disponível para todos os processadores de diretrizes. Se você especificar um processador de diretrizes, 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 aceder aos 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") #>]. Digite sempre as marcas '!', mesmo que omita os nomes opcionais do processador e da 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