Compartilhar via


Namespace Microsoft.VisualStudio.TextTemplating

O Microsoft.VisualStudio.TextTemplating namespace fornece classes para a funcionalidade de transformação do modelo de texto.O mecanismo de transformação do modelo de texto está integrado na 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 de 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 texto clichê 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 assemblies.
Classe pública DirectiveProcessor A classe base abstrata para um processador diretivo concrete.
Classe pública DirectiveProcessorAttribute
Classe pública DirectiveProcessorException A exceção é acionada pelo mecanismo de transformação do 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 sua 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 ServiceProviderExtensions Classe que contém as extensões a IServiceProvider relevante para modelos T4.
Classe pública ShadowCopyMonitor Monitora o estado de assemblies sombra- copiados para o uso de host.
Classe pública SupportedDirectiveAttribute
Classe pública TextTemplatingSession Trivial implementação 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 usado para produzir uma representação específicos da cultura de um Object como um String.
Classe pública TransformedAllTemplatesEventArgs
Classe pública TransformingAllTemplatesEventArgs

Interfaces

  Interface Descrição
Interface pública IDebugTextTemplatingEngine
Interface pública IDebugTransformationRun
Interface pública IDebugTransformationRunFactory
Interface pública IDirectiveProcessor Interface para um processador de diretiva.
Interface pública IDirectiveProcessorMetadata Metadados fornecidos por DirectiveProcessors.Hosts que deseja importar o DPS através de MEF podem consumir esses metadados padrã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 ITextTemplatingOrchestrator
Interface pública ITextTemplatingSession Pode ser usado para passar informações de um processador de diretiva em um modelo de texto.
Interface pública ITextTemplatingSessionHost Implementado por um host templating de texto, ativando chamadores para obter um objeto que indica a sessão atual.Uma sessão representa a série de um dos modelos de texto.O objeto da sessão pode ser usado para passar informações do host no código do modelo de texto.