T4 – direktiva Output
V textových šablonách sady Visual Studio se direktiva output
používá k definování přípony názvu souboru a kódování transformovaného souboru.
Pokud například projekt sady Visual Studio obsahuje soubor šablony s názvem MyTemplate.tt , který obsahuje následující direktivu:
<#@output extension=".cs"#>
pak Visual Studio vygeneruje soubor s názvem MyTemplate.cs.
Direktiva output
není vyžadována v textové šabloně za běhu (předzpracované). Místo toho aplikace získá vygenerovaný řetězec voláním TextTransform()
. Další informace najdete v tématu Generování textu za běhu pomocí textových šablon T4.
Použití výstupní direktivy
<#@ output extension=".fileNameExtension" [encoding="encoding"] #>
V každé textové šabloně by nemělo být více než jedna output
direktiva.
atribut extension
Určuje příponu názvu souboru vygenerovaného textového výstupního souboru.
Výchozí hodnota je .cs.
Příklady: <#@ output extension=".txt" #>
<#@ output extension=".htm" #>
<#@ output extension=".cs" #>
<#@ output extension=".vb" #>
Přijatelné hodnoty: Všechny platné přípony názvu souboru.
atribut kódování
Určuje kódování, které se má použít při generování výstupního souboru. Příklad:
<#@ output encoding="utf-8"#>
Výchozí hodnota je kódování používané souborem textové šablony.
Přijatelné hodnoty: us-ascii
utf-16BE
utf-16
utf-8
utf-7
utf-32
0
(Výchozí systém)
Obecně můžete použít řetězec WebName nebo číslo znakové stránky libovolného kódování vrácené System.Text.Encoding.GetEncodings.