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.
	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).
	ShadowCopyMonitor	Analyse l'état des assemblys ombre- copiés à utiliser par les hôtes.
	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.

Interfaces

	Interface	Description
	IRecognizeHostSpecific	Les processeurs de directive implémentent cette méthode pour obtenir l'état de l'indicateur HostSpecific dans un modèle de texte.