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 tramite modelli di testo T4 pre-elaborati.

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. Ad 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 EncodingGetEncoding().

Cronologia delle modifiche

Data	Cronologia	Motivo
Marzo 2011	Diviso dall'argomento padre.	Miglioramento delle informazioni.