Personnaliser une transformation de texte T4

Les modèles de texte sont une fonctionnalité de Visual Studio qui vous permet de générer du code de programme ou d’autres fichiers texte par le biais d’un processus de transformation. En utilisant un 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 de modèle de texte Décrit le fonctionnement de la 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 directive de modèle de texte T4 personnalisés Le processeur de directives traite des directives dans votre modèle, comme <#@template#>. Il s’exécute pendant la compilation du modèle, et peut charger des assemblys et 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 directives, vous pouvez réduire la complexité de vos modèles.

Appel de la 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 n’importe quel 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 à partir du 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 fournit l’accès aux fichiers externes et à l’état de l’application. Par exemple, l’hôte qui exécute des transformations de texte dans Visual Studio peut fournir l’accès à l’Explorateur de solutions. Il affiche également les erreurs dans la fenêtre de message d’erreur. Si vous souhaitez exécuter des transformations de texte dans un autre contexte, vous pouvez définir votre propre hôte qui fournit 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 de créer votre propre hôte. Pour plus d’informations, consultez Appel d’une transformation de texte dans une extension VS.

Contenu connexe

• Écrire un modèle de texte T4 fournit la syntaxe des directives de modèle de texte et des blocs de contrôle.