Directives de modèles de texte T4

  • Article

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|TrueFromBase"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] [visibility="internal"] [linePragmas="false"] #>

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" #>

Directive CleanUpBehavior T4

<#@ CleanupBehavior processor="T4VSHost" CleanupAfterProcessingtemplate="true" #>

De plus, vous pouvez créer vos propres directives. Pour plus d’informations, consultez Création de processeurs de directive de modèle de texte T4 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.