Directive de sortie T4

Dans les modèles de texte Visual Studio, la directive output sert à définir l’extension du nom de fichier et l’encodage du fichier transformé.

Par exemple, si votre projet Visual Studio comprend un fichier de modèle nommé MyTemplate.tt qui contient la directive suivante :

<#@output extension=".cs"#>

Visual Studio génère alors un fichier nommé MyTemplate.cs

La directive output n'est pas obligatoire dans un modèle de texte au moment de l'exécution (prétraité). Au lieu de cela, votre application obtient la chaîne générée en appelant TextTransform(). Pour plus d’informations, consultez Génération de texte à l’exécution à l’aide des modèles de texte T4.

Utilisation de la directive Output

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

Il ne doit pas y avoir plus d'une directive output dans chaque modèle de texte.

attribut d’extension

Spécifie l’extension de nom de fichier du fichier de sortie texte généré.

La valeur par défaut est .cs

Exemples : <#@ output extension=".txt" #>

<#@ output extension=".htm" #>

<#@ output extension=".cs" #>

<#@ output extension=".vb" #>

Valeurs acceptables : toute extension de nom de fichier valide.

attribut d’encodage

Spécifie l'encodage à utiliser lors de la génération du fichier de sortie. Par exemple :

<#@ output encoding="utf-8"#>

La valeur par défaut est l'encodage utilisé par le fichier de modèle de texte.

Valeurs acceptables : us-ascii

utf-16BE

utf-16

utf-8

utf-7

utf-32

0 (valeur système par défaut)

En général, vous pouvez utiliser la chaîne WebName ou le nombre CodePage de n'importe lequel des encodages retournés par System.Text.Encoding.GetEncodings.