Microsoft.VisualStudio.TextTemplating, espace de noms

L'espace de noms Microsoft.VisualStudio.TextTemplating fournit des classes pour la fonctionnalité de transformation de modèle de texte.Le moteur de transformation de modèle de texte est intégré à Visual Studio et transforme les fichiers de modèle de texte en fichiers de sortie de texte générée.

Le processus de transformation de modèle de texte prend un fichier de modèle de texte comme entrée, exécute la transformation sur l'entrée et génère un nouveau fichier texte comme sortie.Le composant moteur contrôle le processus, et interagit avec un hôte de transformation du modèle de texte et un ou plusieurs processeurs de directive de modèle de texte pour terminer le processus.Pour plus d'informations, consultez Génération de code et modèles de texte T4.

Le processus de transformation de modèle de texte comporte deux étapes.Dans la première étape, le moteur de transformation du modèle de texte crée une classe qui est référencée en tant que classe de transformation générée.Dans la deuxième étape, le moteur compile et exécute la classe de transformation générée, pour produire la sortie de texte générée.La classe de transformation générée comprend le code du modèle de texte, autrement dit, les instructions, expressions, fonctionnalités de classe et texte réutilisable dans le modèle de texte, et les résultats de l'appel des processeurs de directive.Pour plus d'informations, consultez Écriture d'un modèle de texte T4.

Les utilisateurs expérimentés peuvent implémenter leur propre hôte du moteur de la transformation du modèle de texte ou processeurs de directive.Pour plus d'informations, consultez :

• Personnalisation d'une transformation de texte T4

• ITextTemplatingEngineHost

• DirectiveProcessor

• RequiresProvidesDirectiveProcessor

Classes

	Classe	Description
	AssemblyCacheMonitor	Surveille l'état du cache d'assembly.
	DirectiveProcessor	Classe de base abstraite d'un processeur de directive concrète.
	DirectiveProcessorAttribute
	DirectiveProcessorException	Exception levée par le moteur de transformation de modèle de texte si une erreur se produit lors du traitement des directives.
	EncodingHelper	Classe utilitaire qui obtient l'encodage d'un fichier à partir de sa marque d'ordre d'octet.
	Engine	Moteur de transformation du modèle de texte.
	ParameterDirectiveProcessor	Processeur de directive permettant d'acheminer des paramètres sérialisables simples entre les appelants ou l'hôte et le modèle.
	RequiresProvidesDirectiveProcessor	Classe de base abstraite pour un processeur de directive qui définit et implémente un modèle de design appelé requires/provides (requiert/fournit).
	ServiceProviderExtensions	Classe qui contient des extensions de IServiceProvider en rapport avec les modèles T4.
	ShadowCopyMonitor	Surveiller l'état des assemblys ombre- copiés utilisées par les hôtes.
	SupportedDirectiveAttribute
	TextTemplatingSession	Implémentation simple de l'interface de session de transformation de texte.
	TextTransformation	Classe de base abstraite pour toutes les classes de transformation générées.Cette classe fournit également des méthodes utilitaires et des propriétés applicables au code de modèle de texte.
	ToStringHelper	Classe utilitaire utilisée pour produire une représentation spécifique à la culture d'un Object sous la forme d'un String.
	TransformedAllTemplatesEventArgs
	TransformingAllTemplatesEventArgs

Interfaces

	Interface	Description
	IDebugTextTemplatingEngine
	IDebugTransformationRun
	IDebugTransformationRunFactory
	IDirectiveProcessor	Interface pour un processeur de directive.
	IDirectiveProcessorMetadata	Métadonnées fournies par DirectiveProcessors.Les hôtes qui souhaitent importer le DPS via MEF peuvent utiliser ces métadonnées standard.
	IRecognizeHostSpecific	Les processeurs de directive implémentent cette méthode pour obtenir l'état de l'indicateur HostSpecific dans un modèle de texte.
	ITextTemplatingEngine	Interface du moteur de transformation de modèle de texte.
	ITextTemplatingEngineHost	Interface de l'hôte qui transforme les modèles de texte.Elle est disponible pour les processeurs de directive et est également accessible par les modèles de texte.
	ITextTemplatingOrchestrator
	ITextTemplatingSession	Peut être utilisé pour transmettre les informations d'un processeur de directive à un modèle de texte.
	ITextTemplatingSessionHost	Implémenté par un hôte de création de modèles du texte, en permettant aux appelants d'obtenir un objet représentant la session active.Une session représente une série d'exécutions de modèles de texte.L'objet session peut être utilisé pour communiquer des informations de l'hôte au code du modèle de texte.