Freigeben über

T4 Output-Direktive

  • Artikel

In Visual Studio-Textvorlagen wird mithilfe der output-Anweisung die Dateinamenerweiterung und die Codierung der transformierten Datei festgelegt.

Angenommen, Ihr Visual Studio-Projekt enthält eine Vorlagendatei mit dem Namen MeineVorlage.tt, die die folgende Anweisung umfasst:

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

Daraufhin generiert Visual Studio eine Datei namens MeineVorlage.cs.

Die output-Anweisung 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 Ausgabeanweisung

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

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

extension-Attribut

Gibt die Dateierweiterung der generierten Textausgabedatei an.

Der Standardwert lautet .cs.

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

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

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

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

Zulässige Werte: Jede gültige Dateinamenerweiterung.

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.

Zulässige 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 System.Text.Encoding.GetEncodings zurückgegebenen Codierungen verwenden.