Condividi tramite


Direttiva output T4

Nei modelli di testo di Visual Studio, la direttiva output viene utilizzata per definire l'estensione di file e la codifica del file trasformato.

Ad esempio, se il progetto di Visual Studio include un file modello denominato MyTemplate.tt contenente la direttiva seguente:

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

Visual Studio genererà un file denominato MyTemplate.cs

La direttiva di output non è richiesta in un modello di testo (pre-elaborato) della fase di esecuzione.Al contrario, l'applicazione ottiene la stringa generata chiamando TextTransform().Per ulteriori informazioni, vedere Generazione di testo in fase di esecuzione con modelli di testo T4.

Utilizzo della direttiva di output

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

Non deve essere presente più di una direttiva di output in ogni modello di testo.

Attributo extension

Specifica l'estensione del file di output di testo generato.

Il valore predefinito è .cs.

  • Esempi:
    <#@ output extension=".txt" #>

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

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

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

  • Valori accettabili:
    Qualsiasi estensione di file valida.

Attributo encoding

Specifica la codifica da utilizzare quando il file di output viene generato.Di seguito è riportato un esempio:

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

Il valore predefinito è la codifica utilizzata dal file modello di testo.

  • Valori accettabili:
    us-ascii

    utf-16BE

    utf-16

    utf-8

    utf-7

    utf-32

    0 (Impostazione predefinita del sistema)

    In generale, è possibile utilizzare la stringa WebName o il numero di tabella codici di qualsiasi codifica restituita da Encoding.GetEncoding.