资讯

精准传达 • 有效沟通

从品牌网站建设到网络营销策划,从策略到执行的一站式服务

T4TemplateOverview-创新互联

T4 Template的组成

T4 Template Overview

上街网站制作公司哪家好,找创新互联建站!从网页设计、网站建设、微信开发、APP开发、响应式网站建设等网站项目制作,到程序开发,运营维护。创新互联建站自2013年创立以来到现在10年的时间,我们拥有了丰富的建站经验和运维经验,来保证我们的工作的顺利进行。专注于网站建设就选创新互联建站

指令区:为模板转换引擎提供指令,控制模板如何被处理

  • ?  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的三个组件

T4 Template Overview

引擎

T4 Template Overview

如何生成GeneratedTextTransformation

T4 Template OverviewT4 Template Overview

GeneratedTextTransformation运行

T4 Template Overview

使用自定义的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

另外有需要云服务器可以了解下创新互联scvps.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。


新闻标题:T4TemplateOverview-创新互联
网站URL:http://cdkjz.cn/article/desccs.html
多年建站经验

多一份参考,总有益处

联系快上网,免费获得专属《策划方案》及报价

咨询相关问题或预约面谈,可以通过以下方式与我们联系

大客户专线   成都:13518219792   座机:028-86922220