Personnalisation d'une transformation de texte T4

Les modèles de texte représentent une fonctionnalité de Visual Studio qui vous permet de générer du code de programme ou d'autres fichiers texte via un processus de transformation. À l'aide du Kit de développement logiciel (SDK) Visual Studio, vous pouvez étendre le processus de transformation de modèle par défaut en personnalisant le processeur de directive de modèle de texte ou l'hôte de modèle de texte.

Dans cette section

• Processus de transformation du modèle de texte
  Décrit le mécanisme de transformation de texte et explique le rôle de l'hôte de modèle et des processeurs de directive.

• Création de processeurs de directives de modèles de texte personnalisés
  Le processeur de directive traite les directives de votre modèle, telles que <#@template#>.. Il s'exécute pendant la compilation du modèle et peut charger des assemblys, ainsi que d'autres ressources. Il peut également insérer du code qui chargera des ressources au moment de l'exécution. En définissant votre propre processeur de directive, vous pouvez réduire la complexité de vos modèles.

• Appel d'une transformation de texte dans une extension VS
  Si vous écrivez une extension Visual Studio telle qu'une commande de menu ou un gestionnaire d'événements, votre extension peut utiliser le service de création de modèles de texte pour transformer tout modèle de texte. Vous pouvez passer des données de paramètre dans le modèle à l'aide de l'objet Session et obtenir les valeurs dans le modèle à l'aide de la directive <#@parameter#>.

• Traitement des modèles de texte à l'aide d'un hôte personnalisé
  Lorsque le code du modèle de texte s'exécute, l'hôte permet l'accès aux fichiers externes et à l'état de l'application. Par exemple, l'hôte qui exécute les transformations de texte dans Visual Studio peut permettre l'accès à l'Explorateur de solutions. Il affiche également les erreurs dans la fenêtre de message d'erreur. Si vous voulez exécuter des transformations de texte dans un autre contexte, vous pouvez définir votre propre hôte qui permet l'accès aux services disponibles dans ce contexte.

  Si vous écrivez une extension Visual Studio, envisagez d'utiliser le service de transformation de texte existant au lieu d'écrire votre propre hôte. Pour plus d'informations, consultez Invoking Text Transformation in a VS Extension.

Référence

Écriture d'un modèle de texte T4

Fournit la syntaxe des blocs de contrôle et des directives de modèle de texte.

Historique des modifications

Date	Historique	Motif
Janvier 2011	Mis à jour pour discuter du service de création de modèles de texte	Améliorations apportées aux informations.