T4 Output-Direktive

In Visual Studio-Textvorlagen wird die output-Direktive zum Definieren der Dateierweiterung und Codierung der umgewandelten Datei verwendet.

Wenn zum Visual Studio-Projekt beispielsweise eine Vorlagendatei mit dem Namen MyTemplate.tt gehört, die die folgende Direktive enthält:

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

erstellt Visual Studio eine Datei mit dem Namen MyTemplate.cs

Die output-Direktive ist in einer Laufzeitvorlage (vorverarbeiteten Vorlage) nicht erforderlich. Stattdessen erhält die Anwendung die generierte Zeichenfolge durch Aufruf von TextTransform(). Weitere Informationen finden Sie unter Laufzeittextgenerierung mithilfe von T4-Textvorlagen.

Verwenden der Ausgabedirektive

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

In jeder Textvorlage sollte es nicht mehr als eine output-Direktive geben.

extension-Attribut

Gibt die Dateierweiterung der generierten Textausgabedatei an.

Der Standardwert ist .cs

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

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

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

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

• Akzeptierte Werte:
  Jede gültige Dateierweiterung

encoding-Attribut

Gibt die zu verwendende Codierung bei der Generierung der Ausgabedatei an. Beispiel:

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

Der Standardwert ist die Codierung, die von der Textvorlagendatei verwendet wird.

• Akzeptierte Werte:
  us-ascii

  utf-16BE

  utf-16

  utf-8

  utf-7

  utf-32

  0 (Systemstandard)

  Im Allgemeinen können Sie die WebName-Zeichenfolge oder die CodePage-Zahl aller von Encoding.GetEncodings zurückgegebenen Codierungen verwenden.