.NET程序員不要錯過如此強大的T4模板

>>>  技術話題—商業文明的嶄新時代  >>> 簡體     傳統

在Visual Studio中T4文本模板通常以template指令開頭,該指令指定應如何處理模板。本文將給大家做簡單介紹。

AD: WOT2014:用戶標簽系統與用戶數據化運營培訓專場

 

功能強大的T4文本模版

希望您至少能意識到即使有代碼自動生成器,但數據庫結構變更等因素也會給我們帶來不少的麻煩。這種直接放到項目里.tt文件的好處自然不用多說了。有特別的業務需求,在.用partial類來實現,免得模板文件自動更新代碼時將手寫的代碼覆蓋掉。

T4文本模版到底有什么用?什么時候用?

看一下下面這個示例你應該就會明白了:

新建一個控制臺應用程序,刪除里面的所有文件,新建一個Program.tt的文件,并輸入如下內容:


		
  1. <#@ template language="C#"debug="true"#> 
  2. <#@ output extension=".cs"encoding="utf-8"#> 
  3. <#  
  4. stringClassName = "Program";  
  5. #>stringClassName = "Program";  
  6. #> 
  7. namespaceHelloAngel  
  8. {  
  9. usingSystem;  
  10. class<#=ClassName #> 
  11. {  
  12. staticvoidMain(string[] args)  
  13.  {  
  14. Console.WriteLine("Hello Angel");  
  15. }  
  16. }  

保存后我們會看到解決方案資源管理器中是這個樣式的:

此時的Program.cs文件正是我們的Program.tt文件生成的,其內容如下:


		
  1. namespaceHelloAngel  
  2. {  
  3. usingSystem;  
  4. classProgram  
  5. {  
  6. staticvoidMain(string[] args)  
  7. {  
  8. Console.WriteLine("Hello Angel");  
  9. }  
  10. }  

看看下面兩個指令:


		
  1. <#@ template language="C#"debug="true"#> 
  2. <#@ output extension=".cs"encoding="utf-8"#> 

<#@ template #>指令中language指定了我們模板運行使用的語言,可以是VB,或C#,debug聲明了是否使用調試,如果用不到調試,可以設置為false.

<#@ output #>指令中extension指定了輸出文件的擴展名,encoding指定輸出文件的編碼方案。

也就是說,我們可以使用C#語言來寫此模板文件中的邏輯,模板將會輸出一個與模板文件名相同,擴展名為.cs編碼為utf-8的文件。

這里稍作了解下,接下來看看指令的語法吧:

指令的語法如下所示:


		
  1. <#@ DirectiveName [AttributeName = "AttributeValue"] ... #> 

必須將所有特性值放在雙引號內。如果值本身包含引號,則必須使用 字符對這些引號進行轉義。

指令通常是模板文件或包含的文件中的第一個元素。不應將它們放置在代碼塊 <#...#> 內,也不應放置在類功能塊 <#+...#> 之后。

T4 模板指令

<#@ template [language="VB"] [hostspecific="true"] [debug="true"] [inherits="templateBaseClass"] [culture="code"] [compilerOptions="options"] #>

T4 參數指令

<#@ parameter type="Full.TypeName"name="ParameterName"#>

T4 輸出指令

<#@ output extension=".fileNameExtension"[encoding="encoding"] #>

T4 程序集指令

<#@ assembly name="[assembly strong name|assembly file name]"#>

T4 導入指令

<#@ import namespace="namespace"#>

T4 包含指令

<#@ include file="filePath"#>

看了上面的指令后,就試著寫個模板文件生成一些類來練習一下吧:


		
  1. <#@ template language="C#"debug="true"#> 
  2. <#@ output extension=".cs"encoding="utf-8"#> 
  3. <#@ import namespace="System.Collections.Generic"#> 
  4. <#  
  5. List<List<string>classNames =  
  6. new List<string>()  
  7. {  
  8. "Hello",  
  9. "Test"  
  10. };  
  11. List<string>callMethods = new List<string>();  
  12.  #> 
  13. namespace HelloAngel  
  14.  {  
  15. using System;  
  16. <#  
  17. foreach (string className in classNames)  
  18. {  
  19. callMethods.Add(string.Format("{0}.Show();", className));  
  20. #>foreach (string className in classNames)  
  21. {  
  22. callMethods.Add(string.Format("{0}.Show();", className));  
  23. #> 
  24. class <#=className #> 
  25. {  
  26. /// <summary> 
  27. /// <#=className #>的注釋  
  28. /// </summary> 
  29. public static void Show()  
  30. {  
  31. Console.WriteLine("ClassName:<#=className #>");  
  32. }  
  33. }  
  34. <#  
  35. #>}  
  36. #> 
  37. class Program  
  38. {  
  39. /// <summary> 
  40. /// 入口方法的注釋  
  41. /// </summary> 
  42. static void Main(string[] args)  
  43. {  
  44. <#  
  45. foreach (string callMethod in callMethods)  
  46. {  
  47. #>foreach (string callMethod in callMethods)  
  48. {  
  49. #> 
  50. // <#=callMethod #>調用  
  51. <#=callMethod #> 
  52.  <#  
  53. }  
  54. #>}  
  55. #> 
  56. }  
  57. }  

我們一般的項目多是分了簡單三層,有了上面的一些經驗,你應該會想。要是只寫三個類.tt文件,就能自動給我們把整個三層維護好那多令人興奮啊!確實,我就是這樣做了一個項目給大家分享一下:

看看現在整個項目成什么樣子了:

這里不止三個項目了。我加了個UnitTest的項目,一個Adapters的項目,看項目名稱不難看出來,UnitTest項目就是一個測試項目。而Adapters項目呢,是實體適配器項目。先不管它們了。

就這么點東西,已經完成三層的架設了,只是還是Paramter方式的。沒有對存儲過程的支持。十一如果沒有人陪我過的話,我會將對存儲過程的支持添加上去。

建項目的時候建的是.net 4的,這里我把它改為.net2.0的了。不過本人只裝有visual stuido 2010,如果您使用的是Visual studio 2008請您自行將項目文件中的版本號更正,此方法網上有許多。我就不多啰嗦了。

原文鏈接:http://www.cnblogs.com/javennie/archive/2011/09/24/t4.html

 


網載 2014-07-25 18:50:41

[新一篇] 看似簡單!解讀C#程序員最易犯的7大錯誤

[舊一篇] #梆梆安全杯#淺析安卓Native逆向技術
回頂部
寫評論


評論集


暫無評論。

稱謂:

内容:

驗證:


返回列表