我们在2020-3-3-使用T4模板进行C#代码生成 - huangtengxiao介绍了C#使用T4模板生成代码。

今天给大家详细介绍下T4模板的组成


T4模板的组成部分

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

image-20200305112256219

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

image-20200305114021532

image-20200305114119830

文本

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

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

指令块

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

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

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

标准控制块

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

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

表达式控制块

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

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

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

类功能控制块

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

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

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

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



本文会经常更新,请阅读原文: https://xinyuehtx.github.io/post/C-%E4%BB%A3%E7%A0%81%E7%94%9F%E6%88%90%E4%B9%8BT4%E6%A8%A1%E6%9D%BF%E7%BB%84%E6%88%90.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名黄腾霄(包含链接: https://xinyuehtx.github.io ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系