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 :
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). |
![]() |
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. |
![]() |
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. |
![]() |
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. |