Поделиться через


Директива Output T4

В текстовых шаблонах output Visual Studio директива используется для определения расширения имени файла и кодирования преобразованного файла.

Например, если проект Visual Studio содержит файл шаблона с именем MyTemplate.tt который содержит следующую директиву:

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

Затем Visual Studio создаст файл с именем MyTemplate.cs

Директива output не требуется в текстовых шаблонах времени выполнения (предварительно обработанных). Вместо этого приложение получает созданную строку, вызывая TextTransform(). Дополнительные сведения см. в статье Создание текста во время выполнения с помощью текстовых шаблонов T4.

Применение директивы output

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

В каждом текстовом шаблоне должна быть только одна директива output.

Атрибут расширения

Указывает расширение файла созданного файла текстового вывода.

Значение по умолчанию — .cs

Примеры: <#@ output extension=".txt" #>

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

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

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

Допустимые значения: любое допустимое расширение имени файла.

Атрибут кодировки

Задает кодировку для использования при создании выходного файла. Например:

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

Значение по умолчанию — кодировка, используемая файлом текстового шаблона.

Допустимые значения: us-ascii

utf-16BE

utf-16

utf-8

utf-7

utf-32

0 (Системное значение по умолчанию)

Как правило, можно использовать строку WebName или число CodePage любых кодировок, возвращаемых System.Text.Encoding.GetEncodings.