功能強大的T4文本模版

我希望你至少能意識到，即使有了自動代碼生成器，數據庫結構變化等因素也會給我們帶來很多麻煩。直接把.tt文件放到項目中的好處就不用多說了。如果你有特殊的業務需求，可以使用分部類來實現，以免模板文件自動更新代碼時覆蓋掉手寫的代碼。 （北京網出品）

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

看看下面的例子，你應該就明白了：

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

#@templatelanguage='C#'debug='true'#

#@outputextension='.cs'encoding='utf-8'#

#

stringClassName='程序';

#stringClassName='程序';

#

命名空間HelloAngel

{

使用系統；

類#=

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

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

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

看看下面兩個指令：

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. } ?
58. }?

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

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

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

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

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

標簽:北京網站制作 高端網站建設

我們專注高端建站，小程序開發、軟件系統定制開發、BUG修復、物聯網開發、各類API接口對接開發等。十余年開發經驗，每一個項目承諾做到滿意為止，多一次對比，一定讓您多一份收獲！