我们在2020-3-3-使用T4模板进行C#代码生成 - huangtengxiao介绍了C#使用T4模板生成代码。
今天给大家详细介绍下T4模板的组成
T4模板的组成部分
T4模板的组成部分如图所示。主要由文本部分,以及非文本部分的指令(Directives)和控制块(Control blocks)组成。
下面是一个T4模板示例以及最终的生成效果。
文本
文本是直接在生成文件中输出的内容。
所有的文本元素包括空格和缩进都会原封不动的输出到生成文件中。
指令块
指令块由<#@ #> 包裹。主要用于控制模板的处理方式。
例如<#@ assembly name=”System.Core” #> 这句指令,能够在处理模板时,引用System.Core程序集。
这样我们就可以在模板的控制块中,使用System.Core程序集中所包含的方法。
标准控制块
标准控制块由<# #> 包裹。主要用于表示一整段处理代码。
有了标准控制块,我们就可以利用诸如分支,选择等逻辑,对生成的代码进行控制。
表达式控制块
表达式控制块由<#= #> 包裹。
当我们期望将一段表达式,或者某个变量的值,插入生成文本中,就可以使用表达式控制块。
这给了我们利用输入内容生成代码的能力。
类功能控制块
类功能块由<#+ #> 包裹。他表示一些辅助方法。
例如我们这里定义了一个Foo方法返回一个数值的平方。
这可以大大减少重复代码的书写。
不过需要注意的是,类功能控制块只能够写在模板的末尾。
本文会经常更新,请阅读原文: https://dotnet-campus.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 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 dotnet 职业技术学院 (包含链接: https://dotnet-campus.github.io/ ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系 。