Udostępnij za pośrednictwem

Dyrektywa T4 Output

  • Artykuł

W szablonach tekstowych output programu Visual Studio dyrektywa służy do definiowania rozszerzenia nazwy pliku i kodowania przekształconego pliku.

Jeśli na przykład projekt programu Visual Studio zawiera plik szablonu o nazwie MyTemplate.tt który zawiera następującą dyrektywę:

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

następnie program Visual Studio wygeneruje plik o nazwie MyTemplate.cs

Dyrektywa output nie jest wymagana w szablonie tekstowym w czasie wykonywania (wstępnie przetworzonym). Zamiast tego aplikacja uzyskuje wygenerowany ciąg, wywołując metodę TextTransform(). Aby uzyskać więcej informacji, zobacz Generowanie tekstu w czasie wykonywania przy użyciu szablonów tekstu T4.

Korzystanie z dyrektywy Output

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

W każdym szablonie tekstowym nie powinno być więcej niż jednej output dyrektywy.

atrybut rozszerzenia

Określa rozszerzenie nazwy pliku wygenerowanego pliku wyjściowego tekstu.

Wartość domyślna to .cs

Przykłady: <#@ output extension=".txt" #>

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

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

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

Dopuszczalne wartości: dowolne prawidłowe rozszerzenie nazwy pliku.

atrybut kodowania

Określa kodowanie, które ma być używane podczas generowania pliku wyjściowego. Na przykład:

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

Wartość domyślna to kodowanie używane przez plik szablonu tekstowego.

Dopuszczalne wartości: us-ascii

utf-16BE

utf-16

utf-8

utf-7

utf-32

0 (Ustawienie domyślne systemu)

Ogólnie rzecz biorąc, można użyć ciągu WebName lub numeru CodePage dowolnej z kodowań zwracanych przez System.Text.Encoding.GetEncodings.