Gerando arquivos com o utilitário TextTransform

TextTransform.exe é uma ferramenta de linha de comando que pode ser usado para transformar um modelo de texto.Quando você 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 é chamada de scripts.No entanto, não é normalmente necessária, porque é possível executar a transformação de texto em Visual Studio ou no processo de compilação.

Observação

Se você quiser realizar a transformação de texto como parte de um processo de compilação, considere o uso da 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 Visual Studio estiver instalado, você também pode escrever um aplicativo ou Visual Studio extensão que pode transformar modelos de texto.Para obter mais informações, consulte Modelos de processamento de texto por meio de um Host personalizado.

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

\Program Files\Common Files\Microsoft Shared\TextTemplating\11.0

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 <filename>	O arquivo ao qual a saída da transformação é gravada.
-r <assembly>	Um assembly usado para compilar e executar o modelo de texto.
-u <namespace>	Um espaço para nome que é usado para o modelo de compilação.
-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 para módulos (assemblies) especificado no modelo de texto ou usar o -r opção. Por exemplo, para incluir os assemblies usados para a API de Visual Studio, use -P "% VSSHELLFOLDER%\Common7\IDE\PublicAssemblies"
-dp <processorName>! <className>! <assemblyName|codeBase>	O nome, o nome completo do tipo e a montagem de um processador de diretriz que pode ser usado para processar as diretivas personalizadas dentro do modelo de texto.
-a [processorName]![directiveName]! <parameterName>! <parameterValue> Cuidado Sempre digite o '!' marca, mesmo se você omitir o processador opcional e nomes de diretiva.Por exemplo: -a !!param!value	Especifique um valor de parâmetro para um processador de diretriz.Se você especificar apenas o nome do parâmetro e valor, o parâmetro estará disponível para todos os processadores de diretriz.Se você especificar um processador de diretriz, o parâmetro é disponível somente para o processador especificado.Se você especificar um nome de diretiva, o parâmetro está disponível somente quando a diretiva especificada está sendo processada. Para acessar os valores de parâmetro de um processador de diretriz ou modelo de texto, use ResolveParameterValue.Em um modelo de texto, incluir hostspecific na diretriz de modelo e invocar a mensagem em this.Host.Por exemplo: <#@template language="c#" hostspecific="true"#> [<#= this.Host.ResolveParameterValue("", "", "parameterName") #>]
-h	Fornece ajuda.

Tópicos relacionados

Tarefa	Tópico
Gerar arquivos em um Visual Studio solução.	Geração de código de tempo de design usando modelos de texto T4
Processadores de diretriz para transformar suas próprias fontes de dados de gravação.	Personalizando a transformação de texto T4
Um host de modelagem de texto que permite que você chame os modelos de texto do seu próprio aplicativo de gravação.	Modelos de processamento de texto por meio de um Host personalizado