Compartilhar via


Namespace Microsoft.VisualStudio.TextTemplating

O Microsoft.VisualStudio.TextTemplating namespace fornece classes para a funcionalidade de transformação do texto do modelo. O mecanismo de transformação do modelo de texto é integrado ao Visual Studioe transforma os arquivos de modelo de texto em arquivos de saída de texto gerado.

O processo de transformação do modelo de texto leva a um arquivo de modelo de texto como entrada, executa a transformação na entrada e gera um novo arquivo de texto, como a saída. O componente de mecanismo controla o processo e interage com um host de transformação do modelo de texto e um ou mais texto modelo processadores de diretriz para concluir o processo. Para obter mais informações, consulte Modelos de texto T4 e de geração de código.

O processo de transformação do modelo de texto tem duas etapas. Na primeira etapa, o mecanismo de transformação do modelo de texto cria uma classe que é conhecida como a classe de transformação gerada. Na segunda etapa, o mecanismo compila e executa a classe de transformação gerado para produzir a saída de texto gerado. A classe de transformação gerado é composta do código do modelo de texto, ou seja, as instruções, expressões, recursos de classe e timbre no modelo de texto e os resultados da chamada de processadores de diretriz. Para obter mais informações, consulte Escrever um modelo de texto T4.

Usuários avançados talvez queira implementar seus próprio texto modelo transformação mecanismo host ou diretiva processadores. Para obter mais informações, consulte:

Classes

  Classe Descrição
Classe pública AssemblyCacheMonitor Monitora o estado do cache de assembly.
Classe pública DirectiveProcessor A classe base abstrata para um processador de diretriz de concreto.
Classe pública DirectiveProcessorException A exceção que é lançada pelo mecanismo de transformação de modelo de texto, se ocorrer um erro durante o processamento de diretivas.
Classe pública EncodingHelper Uma classe de utilitário que obtém a codificação de um arquivo de marca de ordem de byte.
Classe pública Engine O mecanismo de transformação do modelo de texto.
Classe pública ParameterDirectiveProcessor Processador de diretriz para rotear os parâmetros serializáveis simples de chamadores ou host para o modelo.
Classe pública RequiresProvidesDirectiveProcessor A classe base abstrata para um processador de diretriz que define e implementa um padrão de design chamado requer/fornece.
Classe pública TextTemplatingSession Implementação simples da interface de sessão de transformação de texto
Classe pública TextTransformation A classe base abstrata para todas as classes de transformação gerada.Essa classe também fornece métodos de utilitário e propriedades para usar no código do modelo de texto.
Classe pública ToStringHelper Uma classe de utilitário é usada para produzir uma representação de cultura específica de um Object como um String.

Interfaces

  Interface Descrição
Interface pública IRecognizeHostSpecific Processadores de diretriz implementam esse método para obter o estado do sinalizador HostSpecific em um modelo de texto.
Interface pública ITextTemplatingEngine A interface para o mecanismo de transformação do modelo de texto.
Interface pública ITextTemplatingEngineHost A interface do host que transforma os modelos de texto.Isso está disponível para processadores de diretriz e também pode ser acessado pelos modelos de texto.
Interface pública ITextTemplatingSession Pode ser usado para transmitir informações de um processador de diretriz em um modelo de texto.
Interface pública ITextTemplatingSessionHost Implementado por um host de modelagem de texto, permitindo que os chamadores obter um objeto que indicam a sessão atual.Uma sessão representa uma série de execuções de modelos de texto.O objeto de sessão pode ser usado para passar informações do host no código do modelo de texto.