Partilhar via


T4 Diretiva de saída

Em modelos de texto Visual Studio, a diretiva de output é usada pare definir a extensão do nome de arquivo e a codificação do arquivo transformado.

Por exemplo, se o projeto Visual Studio inclui um arquivo de modelo chamado MyTemplate.tt que contém a seguinte diretiva:

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

em seguida, Visual Studio gerará um arquivo chamado MyTemplate.cs

A diretiva de output não é necessária em um modelo de texto de tempo de execução (pré-processado). Ao invés disso, o aplicativo obtém a cadeia de caracteres gerada ao chamar TextTransform(). Para obter mais informações, consulte Geração de texto de tempo de execução com modelos de texto T4.

Usando a Diretiva de Saída

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

Não deverá haver mais de uma diretiva de output em cada modelo de texto.

Atributo extension

Especifica a extensão do nome de arquivo do arquivo de saída do texto gerado.

O valor padrão é .cs

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

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

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

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

  • Valores aceitáveis:
    Qualquer extensão de nome de arquivo válida.

Atributo encoding

Especifica a codificação usada ao gerar o arquivo de saída. Por exemplo:

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

O valor padrão é a codificação usada pelo arquivo de modelo de texto.

  • Valores aceitáveis:
    us-ascii

    utf-16BE

    utf-16

    utf-8

    utf-7

    utf-32

    0 (Padrão do sistema)

    Em geral, é possível usar a cadeia de caracteres do WebName ou o número da CodePage de qualquer uma das codificações retornadas por Encoding.GetEncodings.