T4模板之基础篇
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了T4模板之基础篇相关的知识,希望对你有一定的参考价值。
一、回顾
上一篇文章 ——T4模板之菜菜鸟篇,我们囫囵吞枣的创建了与“T4模板”有关的文件。在创建各个文件的这一个过程中,我们对于T4模板有了那么丁点的认识。现在就带着之前的那些问题,正式的迈入对“T4模板”的学习。
二、概念
2.1、类型
T4 文本模板有两种类型:
- 设计时 T4 文本模板
- 运行时 T4 文本模板
三、简要教程
我们只讲“设计时T4文本模板”,其他的都TMD属于高级部分了,哥不懂给不给?
打开之前我们创建的“TextTemplate_.tt”文件:
很明显的有一个特征,那么就是他们都是这种模式:
<#@ 指令 属性=“值”#>
就这样定了,我们按行来学习
3.1、指令:
3.1.1、模板指令
<#@ template debug="false" hostspecific="false" language="C#"#>
说的是这个模板,不可以调试,不提供host这个属性,用的是C#语言。它的完整模式如下,中括号表示可选,没有写它将按照默认处理。
<#@ template [language="VB"] [compilerOptions="options"] [culture="code"] [debug="true"] [hostspecific="true"] [inherits="templateBaseClass"] [visibility="internal"] [linePragmas="false"] #>
3.1.2、程序集指令
<#@ assembly name="System.Core"#> 它的作用类似于在 Visual Studio 项目中添加程序集引用。
3.1.3、导入指令
<#@ import namespace="System.Linq"#> 它等效于 C# 中的 “using System.Linq;”。
3.1.4、输出指令
<#@ output extension=".txt" #> 它就是告诉你,T4模板最终将生产.txt对应后缀的文件。
3.2、控制块
不难发现,如上截图,我们生成的“TextTemplate_.txt”它里面确实是什么内容都没有的。因此,更进一步的学习是“控制块”,对于不同控制块的组合,便能生成我们所需要的文件。
-
<# 标准控制块 #> 可以包含语句。
-
<#= 表达式控制块 #> 可以包含表达式。
-
<#+ 类特征控制块 #> 可以包含方法、字段和属性,就像一个类的内部
3.3、心动不如行动
唱首歌吧!“我是一只小小小鸟……”:
我是zeje,我们来定义一个变量 string name =“zeje”,再看看效果:
哥已经压抑了很久了,一起来呐喊吧:
发泄够了吧?仔细想想,这个类<#+ 类特征控制块 #> 还没用上。好吧,zeje就在这里自我介绍下吧:
既然都自我介绍过了,是不是可以开溜了呢?还是给大家都个红包吧!(这里可能需要另外说明,先凑合着看吧!)
生成结果如下:
上面涉及到额外的知识点:使用T4模板输出多文件,请自行学习。
四、高级篇
其实对于“T4模板”的学习,讲得最详细的还是MSDN,下面给出对应的链接,可以点开深入的了解。
- T4 文本模板编写准则
- 使用 T4 文本模板生成设计时代码
- 演练:使用文本模板生成代码
- 生成过程中的代码生成
- 文本模板的安全性
- 使用 TextTransform 实用工具生成文件
- 使用 T4 文本模板的运行时文本生成
- 编写 T4 文本模板
- T4 文本模板指令
- T4 模板指令
- T4 参数指令
- T4 输出指令
- T4 程序集指令
- T4 导入指令
- T4 包含指令
- T4 CleanUpBehavior 指令
- 文本模板控制块
- 文本模板实用工具方法
- 从文本模板访问 Visual Studio 或其他主机
- 在文本模板中使用转义序列
- 如何:使用转义序列从模板生成模板
- 调试 T4 文本模板
- T4 文本模板编写准则
- 如何:使用文本模板 ...
- 自定义 T4 文本转换
- 文本模板转换过程
- 创建自定义 T4 文本模板指令处理器
- 部署自定义指令处理器
- 演练:创建自定义指令处理器
- 在 VS 扩展中调用文本转换
- 使用自定义宿主处理文本模板
- 演练:创建自定义文本模板宿主
- T4 文本模板的 API 参考
- 命名空间
- Microsoft.VisualStudio.TextTemplating
- Microsoft.VisualStudio.TextTemplating.Modeling
- Microsoft.VisualStudio.TextTemplating.VSHost
以上是关于T4模板之基础篇的主要内容,如果未能解决你的问题,请参考以下文章