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.
.gif "Observação") Observaçã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> .gif "Observação de cuidado") Cuidado
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: |
-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. |
|
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. |