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

alors Visual Studio génèrera 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 durant 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 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 encoding

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 Encoding.GetEncodings.