Personalizando a transformação de texto T4

Modelos de texto são um recurso do Visual Studio que permitem que você gerar o código de programa ou outros arquivos de texto por meio de um processo de transformação. Usando SDK do Visual Studio, você pode estender o processo de transformação do modelo padrão Personalizando o processador de diretriz de modelo de texto ou o host de modelo de texto.

Nesta seção

  • O processo de transformação do modelo de texto
    Descreve como funciona a transformação de texto e explica a função do host do modelo e processadores de diretriz.

  • A criação de processadores de diretiva de modelo de texto personalizado
    O processador de diretriz lida com diretivas no seu modelo, como <#@template#>. ele é executado durante a compilação do modelo e pode carregar módulos (assemblies) e outros recursos. Ele também pode inserir o código que irá carregar recursos em tempo de execução. Definindo seu próprio processador de diretriz, você pode reduzir a complexidade de seus modelos.

  • Invocar a transformação de texto em uma extensão do VS
    Se você estiver escrevendo um Visual Studio extensão como um manipulador de eventos ou comando de menu, a sua extensão pode usar o serviço de modelagem de texto para transformar qualquer modelo de texto. Você pode passar dados de parâmetro para o modelo usando o objeto de sessão e obter os valores a partir do modelo usando o <#@parameter#> diretiva.

  • Modelos de texto de processamento por meio de um Host personalizado
    Quando o código do modelo de texto é executado, o host fornece acesso a arquivos externos e o estado do aplicativo. Por exemplo, o host que executa transformações de texto em Visual Studio pode fornecer acesso ao solution explorer. Ele também exibe os erros na janela da mensagem de erro. Se você quiser executar transformações de texto em um contexto diferente, você pode definir seu próprio host que fornece acesso aos serviços disponíveis nesse contexto.

    Se você estiver escrevendo um Visual Studio a extensão, considere o uso do serviço de transformação de texto existente em vez de escrever seu próprio host. Para obter mais informações, consulte Invocar a transformação de texto em uma extensão do VS.

Referência

Escrever um modelo de texto T4

Fornece a sintaxe das diretivas de modelo de texto e blocos de controle.

Histórico de alterações

Date

History

Motivo

Janeiro de 2011

Atualizado para abordar o serviço de modelagem de texto

Aprimoramento de informações.