Directive de sortie T4

Dans les modèles de texte Visual Studio, la directive output est utilisée pour définir l'extension de nom de fichier et l'encodage du fichier transformé.

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

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

Visual Studio générera un fichier nommé MyTemplate.cs

La directive output n'est pas requise dans un modèle de texte au moment de l'exécution (prétraité). À la place, 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 de modèles de texte T4 prétraités.

Utilisation de la directive de sortie

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

Chaque modèle de texte ne doit contenir qu'une seule directive output.

Attribut extension

Spécifie l'extension de nom du fichier de sortie de 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 lorsque le fichier de sortie est généré. 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 numéro de page de codes de l'un des encodages retournés par EncodingGetEncoding().

Historique des modifications

Date	Historique	Motif
Mars 2011	Fractionnement de rubrique parent.	Améliorations apportées aux informations.