C#T4模板语法快速入门

  • A+

C#T4模板语法快速入门

一.什么是T4?

T4,即4个T开头的英文字母组合:Text Template Transformation Toolkit。T4(Text Template Transformation Toolkit)是微软官方在VisualStudio 2008中开始使用的代码生成引擎。简单的说就是可以根据模板生成你想要的文件,可以使类文件,文本文件,HTML等等。

VS本身只提供一套基于T4引擎的代码生成的执行环境,由下面程序集构成:

Microsoft.VisualStudio.TextTemplating.10.0.dll

Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll

Microsoft.VisualStudio.TextTemplating.Modeling.10.0.dll

Microsoft.VisualStudio.TextTemplating.VSHost.10.0.dll

二.VS插件的安装

T4的编辑工具下载地址http://t4-editor.tangible-engineering.com/Download_T4Editor_Plus_ModelingTools.html

VS默认的编辑工具无高亮,无提示,错误不易定位。

三.T4语法

T4语法和c#语法类似,但是有不同于c#语法。

T4语法主要包括三类:1指令 2文本块 3指令块

  1. <# 标准控制块 #> 可以包含语句。  
  2. <#= 表达式控制块 #> 可以包含表达式。  
  3. <#+ 类特征控制块 #> 可以包含方法、字段和属性,就像一个类的内部  

指令主要包括template, output, assembly, import, include等类型

在这里是指令T4语法以<#开头结尾 <#@ 指令 属性=“值”#>

第一种指令集

  • 模板指令
    1. <#@ template debug="false" hostspecific="false" language="C#" #>  
    1.  langeuage:输出语言,有效值C#、VB,默认为C#  
    2.  debug:是否启用调试,有效值truefalse,默认为false。  
    3. hostspecific:有效值truefalse,默认为false。如果将此特性的值设置为 true,则会将名为 Host 的属性添加到由文本模板生成的类中。 该属性是对转换引擎的宿主的引用,并声明为Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost。  
    4.  inherits:可以指定模板的程序代码可以继承自另一个类,这个类也可以从文本模板生成。目前木有使用过,基本上可以忽略  
  • 输出指令
    1. <#@ output extension=".cs" #>    

    告诉T4引擎生成文件的后缀名是.cs

  • 程序集指令
    1. <#@ assembly name="System"#>    
    1. 告诉T4引擎编译运行时引用System程序集    
    2. $(SolutionDir):当前项目所在解决方案目录    
    3. $(ProjectDir):当前项目所在目录    
    4. $(TargetPath):当前项目编译输出文件绝对路径    
    5. $(TargetDir):当前项目编译输出目录,即web项目的Bin目录,控制台、类库项目bin目录下的debug或release目录(取决于当前的编译模式)    
    6.    
    7. 举个例子:比如我们在D盘根目录建立了一个控制台项目MyTest,解决方案目录为D:\Test,项目目录为    
    8. D:\Test\MyTest,那么此时在Debug编译模式下    
    9. $(SolutionDir)的值为D:\Test    
    10. $(ProjectDir)的值为D:\Test\MyTest    
    11. $(TargetPath)值为D:\Test\MyTest\bin\Debug\MyTest.exe    
    12. $(TargetDir)值为D:\Test\MyTest\bin\Debug\    
  • 导入指令
    1. <#@ import namespace="System.Data"#>  

    告诉T4引擎编译运行时引用某个名称空间。在 Visual Studio T4 文本模板的代码块中,import 指令允许您在不提供完全限定名称的情况下引用另一个命名空间中的元素。 它等效于 C# 中的 using 或 Visual Basic 中的 imports。默认已经导入了System命名空间的引用。

  • 包含指令
    1. <#@ include file="Base.ttinclude"#>  

    运行时引用某个文件,类似于JS的引用。

    包含指令可以提高代码复用率,比如我们可以将一些常用的程序集、命名空间引用放到一个文件里,使用时仅需要引用下即可,省去了每次都要重新引用一遍的烦恼,如我们建立Reference.ttinclude文件,里面包含了我们平时常用的程序集引用。

    1. <#@ assembly name="System.Core.dll" #>  
    2. <#@ assembly name="System.Data.dll" #>  
    3. <#@ assembly name="System.Data.DataSetExtensions.dll" #>  
    4. <#@ assembly name="System.Xml.dll" #>  
    5. <#@ import namespace="System" #>  
    6. <#@ import namespace="System.Xml" #>  
    7. <#@ import namespace="System.Linq" #>  
    8. <#@ import namespace="System.Data" #>  
    9. <#@ import namespace="System.Data.SqlClient" #>  
    10. <#@ import namespace="System.Collections.Generic" #>  
    11. <#@ import namespace="System.IO" #>  

    使用时只需要使用包含指令引用下即可

    1. <#@ include file="$(ProjectDir)Reference.ttinclude"  #>  
  • 参数指令
    1. <#@ parameter type="string" name="ParameterName" #>  

    顾名思义就是定义一个参数在其他的地方使用。

    第二种文本块

    文本块直接向输出文件插入文本。 文本块没有特殊格式,就像我们刚才初体验中写的类一样。

    第三种指令块

    主要用于控制文本的输出。在控制块可以写任意的C#代码。

  • 标准控制块:
    1. <#  
    2.     for(int i = 0; i < 4; i++)  
    3.     {  
    4. #>  
    5. Hello World!  
    6. <#  
    7.     }   
    8. #>  
  • 表达式控制块:
    1. <#= 1 + 1 #>   
  • 类控制块:
    1. <#+  
    2.     public class config  
    3.     {  
    4.         public static readonly string ConnectionString = "Data Source=(local);Initial Catalog=NFineBase;User ID=sa;Password=hjf19870810;";  
    5.         public static readonly string DbDatabase = "NFineBase";  
    6.         public static readonly string TableName = "Sys_Test";  
    7.     }  
    8. #>  

    例如在这里写一个类,在其他的地方我们可以使用这个类的东西。

    钰玺

    发表评论

    :?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: