T4模板的组成部分如图所示。主要由文本部分,以及非文本部分的指令(Directives)和控制块(Control blocks)组成。

C#代码生成之T4模板组成 - 图1

下面是一个T4模板示例以及最终的生成效果。

C#代码生成之T4模板组成 - 图2

C#代码生成之T4模板组成 - 图3

文本


文本是直接在生成文件中输出的内容。

所有的文本元素包括空格和缩进都会原封不动的输出到生成文件中。

指令块


指令块由<#@ #> 包裹。主要用于控制模板的处理方式。

例如<#@ assembly name=“System.Core” #> 这句指令,能够在处理模板时,引用System.Core程序集。

这样我们就可以在模板的控制块中,使用System.Core程序集中所包含的方法。

标准控制块


标准控制块由<# #> 包裹。主要用于表示一整段处理代码。

有了标准控制块,我们就可以利用诸如分支,选择等逻辑,对生成的代码进行控制。

表达式控制块


表达式控制块由<#= #> 包裹。

当我们期望将一段表达式,或者某个变量的值,插入生成文本中,就可以使用表达式控制块。

这给了我们利用输入内容生成代码的能力。

类功能控制块


类功能块由<#+ #> 包裹。他表示一些辅助方法。

例如我们这里定义了一个Foo方法返回一个数值的平方。

这可以大大减少重复代码的书写。

不过需要注意的是,类功能控制块只能够写在模板的末尾。