Directive de sortie T4T4 Output Directive

Dans les modèles de texte Visual StudioVisual Studio, la directive output sert à définir l'extension du nom de fichier et l'encodage du fichier transformé.In Visual StudioVisual Studio text templates, the output directive is used to define the file name extension and encoding of the transformed file.

Par exemple, si votre Visual StudioVisual Studio projet inclut un fichier modèle nommé MyTemplate.tt qui contient la directive suivante :For example, if your Visual StudioVisual Studio project includes a template file named MyTemplate.tt which contains the following directive:

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

puis Visual StudioVisual Studio génère un fichier nommé MyTemplate.csthen Visual StudioVisual Studio will generate a file named MyTemplate.cs

La directive output n'est pas obligatoire dans un modèle de texte au moment de l'exécution (prétraité).The output directive is not required in a run-time (preprocessed) text template. Au lieu de cela, votre application obtient la chaîne générée en appelant TextTransform().Instead, your application obtains the generated string by calling TextTransform(). Pour plus d’informations, consultez génération de texte d’exécution avec les modèles de texte T4.For more information, see Run-Time Text Generation with T4 Text Templates.

Utilisation de la directive OutputUsing the Output Directive

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

Il ne doit pas y avoir plus d'une directive output dans chaque modèle de texte.There should be no more than one output directive in each text template.

attribut d’extensionextension attribute

Spécifie l’extension de nom de fichier du fichier de sortie texte généré.Specifies the file name extension of the generated text output file.

La valeur par défaut est .csThe default value is .cs

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

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

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

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

Valeurs acceptables :Acceptable Values:
toute extension de nom de fichier valide.Any valid file name extension.

attribut d’encodageencoding attribute

Spécifie l'encodage à utiliser lors de la génération du fichier de sortie.Specifies the encoding to use when the output file is generated. Par exemple :For example:

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

La valeur par défaut est l'encodage utilisé par le fichier de modèle de texte.The default value is the encoding used by the text template file.

Valeurs acceptables :Acceptable Values:
us-ascii

utf-16BE

utf-16

utf-8

utf-7

utf-32

0 (valeur système par défaut)0 (System default)

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.In general, you can use the WebName string or the CodePage number of any of the encodings returned by System.Text.Encoding.GetEncodings.