通过

T4 输出指令

  • 项目

更新：2011 年 3 月

在 Visual Studio 文本模板中，output 指令用于定义已转换文件的文件扩展名和编码。

例如，如果您的 Visual Studio 项目包括名为 MyTemplate.tt 的模板文件，该模板文件包含以下指令：

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

则 Visual Studio 将生成名为 MyTemplate.cs 的文件

运行时（预处理）文本模板中不需要 output 指令。 相反，应用程序通过调用 TextTransform() 来获取已生成的字符串。 有关更多信息，请参见使用预处理 T4 文本模板生成运行时文本。

使用输出指令

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

每个文本模板中不应该有多个 output。

extension 特性

指定生成的文本输出文件的文件扩展名。

默认值为 .cs

  • 示例：
    <#@ output extension=".txt" #>

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

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

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

  • 可接受的值：
    任何有效的文件扩展名。

encoding 特性

指定生成输出文件时要使用的编码。 例如：

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

默认值为文本模板文件使用的编码。

  • 可接受的值：
    us-ascii

    utf-16BE

    utf-16

    utf-8

    utf-7

    utf-32

    0（系统默认）

    一般情况下，可以使用 WebName 字符串或 EncodingGetEncoding() 返回的任一编码的 CodePage 编号。

修订记录

日期

修订记录

原因

2011 年 3 月

从父主题中拆分出来。

信息补充。