T4TemplateOverview
T4 Template的组成
成都创新互联公司是一家集网站建设,禹王台企业网站建设,禹王台品牌网站建设,网站定制,禹王台网站建设报价,网络营销,网络优化,禹王台网站推广为一体的创新建站企业,帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿,时刻以成就客户成长自我,坚持不断学习、思考、沉淀、净化自己,让我们为更多的企业打造出实用型网站。
指令区:为模板转换引擎提供指令,控制模板如何被处理
? template:模板相关的属性,debug是否可以调试;hostspecific设置为true时,为生成的模板类中添加Host属性
? output:生成输出文件类型
? assembly:模板引擎中引用的程序集
? import:模板引擎中导入的命名空间
? include:包含其他文件,在最终转换时,将这些引用的文件和当前文件进行合并
代码控制区
? 标准代码控制区,<#...#>包围的区域,包含标准的代码
? 表达式控制区,<#=...#>包围的区域,计算表达式的值,插入到最终输出文件中
? 类特性控制区,<#+...#>包围的区域,定义类、属性、方法等,主要用于帮助类或者帮助方法,可以其他代码区域引用这里定义的类和方法,该区域中包含的代码可以放在单独文件中,然后include到当前文件中
T4 工具方法
? Write,WriteLine:向模板中写入数据文本
? Error,在VS的Error Window面板显示错误
? Warning,在VS的Error Window面板显示警告
更多方法,请参考:http://msdn.microsoft.com/en-us/library/bb126474.aspx
Host属性:引用模板转换引擎的宿主
? Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost类型
? 使用Host.ResolvePath()引用相对于模板的路径
? 使用Host.LogErrors打印错误信息,如果宿主是VS的话,就是向Error Window打印错误警告信息
? 如果是在VS中使用,可以访问VS的API
建议的开发流程
? T4模板不是编写代码的理想环境(没有智能提示等)
? 首先在其他工程中实现模板需要的功能
? 将工程的代码迁移到T4模板中
? 如何Debug T4模板
? 首先建议采用上面说的开发流程,T4模板的Debug是用来解决迁移过程中出现的问题
? template指令设置debug="true“
? 添加断点
? 在模板文件中右键Debug T4 Template
T4 Template的三个组件
引擎
如何生成GeneratedTextTransformation
GeneratedTextTransformation运行
使用自定义的TextTransformation
GeneratedTextTransformation继承自TextTransformation,如果要使用另外一套方法集,可以定义继承自TextTransformation的类,然后在template指令的inherits属性指定为该类
宿主
? 加载引擎或者指令处理器需要的文本文件或者二进制文件,比如加载程序集、指令处理器代码文件,也可以读取文本文件,将它们的内容作为字符串返回
? 为引擎创建GeneratedTextTransformation类提供一组标准的程序集和命名空间
? 为引擎编译和执行GeneratedTextTransformation类提供AppDomain,使用独立的AppDomain是为保护宿主应用程序(VS)不受模板文件中错误的影响
? 将生成的结果写入输出文件
? 为生成的输出文件设置默认扩展名
? 处理文件转换过程中出现的错误,比如写入文件中,又比如VS将错误显示到Error Window中
? 为指令提供默认值,比如language默认值C#
自定义宿主
创建并运行自己的工程,引用Microsoft.VisualStudio.TextTemplating.11.0.dll和Microsoft.VisualStudio.TextTemplating.Interfaces.11.0.dll,主要是使用Engine的ProcessTemplate
更详细流程请参考官方文档:http://msdn.microsoft.com/en-us/library/bb126579.aspx
指令处理器
? 提供公共功能,访问外部资源或数据
? 引擎将指令转换为代码,添加到GeneratedTextTransformation中,比如Import指令最终添加为using代码语句
自定义指令处理器:
需要创建继承自DirectiveProcessor或者RequiresProvidesDirectiveProcessor的类,该类的重要接口如下
? bool IsDirectiveSupported(string directiveName)支持哪些指令,只有返回true的指令名称,才会进行下一步的处理
? void ProcessDirective (string directiveName, IDictionary
arguments)处理指令时,引擎调用这个方法,一般是将指令名称和参数保存下来为后面的操作做准备 ? string[] GetReferencesForProcessingRun()返回模板需要的程序集名称
? string[] GetImportsForProcessingRun()返回模板需要的命名空间
? string GetClassCodeForProcessingRun()向GeneratedTextTransformation类中插入的实际代码,定义了公共功能如属性、方法等的代码
部署指令处理器
? Visual Studio Extension (VSIX)
? VSPackage
? 注册表
详细部署流程,请参考官方文档:http://msdn.microsoft.com/en-us/library/cc138364.aspx
参考文档和资料
http://msdn.microsoft.com/en-us/library/bb126445.aspx
http://www.cnblogs.com/artech/archive/2010/11/16/T4_Assembly_Locking_Debug.html
http://www.cnblogs.com/artech/archive/2010/10/23/1859529.html
http://www.hanselman.com/blog/T4TextTemplateTransformationToolkitCodeGenerationBestKeptVisualStudioSecret.aspx
新闻名称:T4TemplateOverview
网站URL:http://pwwzsj.com/article/ppccpg.html