Directives de modèles de texte T4

Les directives fournissent des instructions au moteur de transformation de modèle de texte.

La syntaxe des directives est la suivante :

<#@ DirectiveName [AttributeName = "AttributeValue"] ... #>

Toutes les valeurs d'attribut doivent être placées entre guillemets doubles. Si la valeur elle-même contient des guillemets, ils doivent être placés dans une séquence d'échappement au moyen du caractère \.

En général, les directives sont les premiers éléments d'un fichier modèle ou d'un fichier inclus. Vous ne devez pas les placer à l'intérieur d'un bloc de code <#...#> ou après un bloc de fonctionnalité de classe <#+...#>.

• Directive du modèle T4

  <#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>
  

• Directive du paramètre T4

  <#@ parameter type="Full.TypeName" name="ParameterName" #>
  

• Directive de sortie T4

  <#@ output extension=".fileNameExtension" [encoding="encoding"] #>
  

• Directive d'assembly T4

  <#@ assembly name="[assembly strong name|assembly file name]" #>
  

• Directive d'importation T4

  <#@ import namespace="namespace" #>
  

• Directive d'inclusion T4

  <#@ include file="filePath" #>
  

De plus, vous pouvez créer vos propres directives. Pour plus d'informations, consultez Création de processeurs de directives de modèles de texte personnalisés. Si vous utilisez le Kit de développement logiciel de visualisation et de modélisation pour créer un langage spécifique à un domaine (DSL), un processeur de directive sera généré dans le cadre de votre DSL.

Historique des modifications

Date	Historique	Motif
Mars 2011	Contenu fractionné dans des rubriques enfants.	Améliorations apportées aux informations.
Juin 2010	Utilisez $(SolutionDir) dans la directive d'assembly. Dans les modèles prétraités, utilisez à la place les références de projet. <#@Parameter#> ajouté. Notes ajoutées sur les héritages et la génération d'un assembly auquel vous faites référence dans un modèle.	Commentaires client.