Compartilhar via

Personalizando a transformação de texto T4

  • Artigo

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 através 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 do 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 os processadores de diretriz.

  • Criação de processadores de diretiva de modelo personalizado T4 texto
    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.Ao definir 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 a extensão como, por exemplo, um manipulador de eventos ou comando de menu, 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 um modelo usando o objeto de sessão e obter os valores de dentro do modelo usando o <#@parameter#> diretiva.

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

    Se você estiver escrevendo um Visual Studio extensão, considere usar o 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.