Gerando arquivos com o utilitário TextTransform

TextTransform.exe é uma ferramenta de linha de comando que você pode usar para transformar um modelo de texto. Quando você chamar TextTransform.exe, você especificar 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.

ObservaçãoObservação

Se você deseja executar 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 texto de processamento por meio de um Host personalizado.

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

\Program Files\Common Files\Microsoft Shared\TextTemplating\10.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 procurar os assemblies especificados dentro do modelo de texto ou usando 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>

Observação de cuidadoCuidado
Digite sempre 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 de parâmetro e o valor, o parâmetro estará disponível para todos os processadores de diretriz. Se você especificar um processador de diretriz, o parâmetro está 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 o modelo de texto, use ResolveParameterValue(String, String, String). 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 permite que você chame os modelos de texto do seu próprio aplicativo de gravação.

Modelos de texto de processamento por meio de um Host personalizado

Histórico de alterações

Date

History

Motivo

Junho de 2010

Adicionadas informações sobre a opção de –a.

Comentários do cliente.