2. 程式人生 > >T4模版引擎之基礎入門

T4模版引擎之基礎入門

阿新 • • 發佈：2018-01-03
如何 inf 添加引用 研究 變量 sta word lis ports

　　額，T4好陌生的名字，和NuGet一樣很悲催，不為世人所熟知，卻又在背後默默無聞的奉獻著，直到現在我們項目組的人除了我之外，其它人還是對其豪無興趣，基本上是連看一眼都懶得看，可憐的娃啊。。。

　　T4(Text Template Transformation Toolkit)是微軟官方在VisualStudio 2008中開始使用的代碼生成引擎。在 Visual Studio 中，“T4 文本模板”是由一些文本塊和控制邏輯組成的混合模板，它可以生成文本文件。 在 Visual C# 或 Visual Basic 中，控制邏輯編寫為程序代碼的片段。生成的文件可以是任何類型的文本，例如網頁、資源文件或任何語言的程序源代碼。現在的VS中只要與代碼生成相關的場景基本上都能找T4的身影，比如MVC的視圖模板，Entity Framwork的DataContext模板等等。

　　在學習枯燥的概念前我們先來看一下用T4模版快速生成POCO實體類的示例
打開VS2010建一個項目，然後右擊項目文件選擇新建項，在文件列表中找到文件模版，如圖所示

技術分享圖片

技術分享圖片

修改TextTemplate1.tt文件內容如下

復制代碼 
<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".cs" #>
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace ConsoleApplication1
{    
    public class User
    {
        /// <summary>
        /// 用戶ID
        /// </summary>
        public int UserID { get; set; }

        /// <summary>
        /// 用戶名
        /// </summary>
        public string UserName { get; set; }

        /// <summary>
        /// 密碼
        /// </summary>
        public string Password { get; set; }

        /// <summary>
        /// Email
        /// </summary>
        public string Email { get; set; }

        /// <summary>
        /// 手機號
        /// </summary>
        public string Mobile { get; set; }
    }
}
復制代碼

點擊Ctrl+S然後可以看到自動生成了一個TextTemplate1.cs文件

復制代碼 
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace ConsoleApplication1
{    public class User
    {
        /// <summary>
        /// 用戶ID
        /// </summary>
        public int UserID { get; set; }

        /// <summary>
        /// 用戶名
        /// </summary>
        public string UserName { get; set; }

        /// <summary>
        /// 密碼
        /// </summary>
        public string Password { get; set; }

        /// <summary>
        /// Email
        /// </summary>
        public string Email { get; set; }

        /// <summary>
        /// 手機號
        /// </summary>
        public string Mobile { get; set; }
    }
}
復制代碼

是不是很神奇，T4模版引擎會根據你在模版裏定義的內容自動生成相應的文件，當然本示例過於簡單，完全不能展現T4的強大，當你若真正了解T4後，會發現神馬代碼生成器全都是浮雲，T4才是王道，利用T4你完全可以輕松生成屬於自己風格的任何類型代碼，在下篇文章會有實例展示如何通過T4連接數據庫自動生成POCO類，基本上這個才是我們用T4的最大意圖，呵呵，在這之前還是老老實實看看枯燥乏味的T4基礎知識吧。

T4 文本模板有兩種類型：設計時 T4 文本模板和運行時 T4 文本模板（“預處理過的”模板）

  • 設計時模版

　　可在應用程序中執行運行時 T4 文本模板（“預處理過的”模板）以便生成文本字符串（通常作為其輸出的一部分）。

　　若要創建運行時模板，請向您的項目中添加“已預處理的文本模板”文件。 另外，您還可以添加純文本文件並將其“自定義工具”屬性設置為“TextTemplatingFilePreprocessor”。

　　有關更多信息，請參見使用預處理 T4 文本模板生成運行時文本。 有關模板語法的更多信息，請參見編寫 T4 文本模板。

  • 運行時模版

　　在 Visual Studio 中執行設計時 T4 文本模板，以便定義應用程序的部分源代碼和其他資源。

　　通常，您可以使用讀取單個輸入文件或數據庫中的數據的多個模板，並生成一些 .cs、.vb 或其他源文件。 每個模板都生成一個文件。 在 Visual Studio 或 MSBuild 內執行它們。

　　若要創建設計時模板，請向您的項目中添加“文本模板”文件。 另外，您還可以添加純文本文件並將其“自定義工具”屬性設置為“TextTemplatingFileGenerator”。

　　有關更多信息，請參見使用 T4 文本模板生成設計時代碼。 有關模板語法的更多信息，請參見編寫 T4 文本模板。　

文本模板由以下部件組成：

  • 指令 - 控制模板處理方式的元素。

  • 文本塊 - 直接復制到輸出的內容。

  • 控制塊 - 向文本插入可變值並控制文本的條件或重復部件的程序代碼。　

T4 文本模板指令

  • T4模版指令 
    <#@ template [language="C#"] [compilerOptions="options"] [culture="code"] [debug="true"] [hostspecific="true"] [inherits="templateBaseClass"] #>
  1. 模版指令中所有特性均為可選的
  2. langeuage:輸出語言，有效值C#、VB，默認為C#
  3. debug:是否啟用調試，有效值true、false，默認為false。特別說明下這個調試真的不咋地，很容易讓VS崩潰，很雞肋的功能，
  4. hostspecific:有效值true、false，默認為false。如果將此特性的值設置為 true，則會將名為 Host 的屬性添加到由文本模板生成的類中。 該屬性是對轉換引擎的宿主的引用，並聲明為Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost。
  5. inherits：可以指定模板的程序代碼可以繼承自另一個類，這個類也可以從文本模板生成。目前木有使用過，基本上可以忽略
  6. compilerOptions:有效值為任何有效的編譯器選項。基本上可以忽略
  • T4 參數指令 
    <#@ parameter type="Full.TypeName" name="ParameterName" #>

    　顧名思義，就是用來傳參的，應該是用在運行時模版的(預處理模版)

  • T4 輸出指令 
    <#@ output extension=".fileNameExtension" [encoding="encoding"] #>

    比較重要的指令，用於設置輸出文件的後綴名和文件編碼
    extension:輸出文件擴展名，默認為".cs"
    encoding:文件編碼,默值為utf-8（這裏不能確定，我測試是utf-8）

  • T4 程序集指令 
    <#@ assembly name="[assembly strong name|assembly file name]" #>
  1. 程序集指令相當於VS裏面我們添加程序集引用的功能，該指令只有一個參數name，用以指定程序集名稱，如果程序集已經在GAC裏面註冊，那麽只需要寫上程序集名稱即可，如<#@ assembly name="System.Data.dll" #>，否則需要指定程序集的物理路徑。
  2. T4模版的程序集引用是完全獨立的，也就是說我們在項目中引用了一些程序集，然後項目中添加了一個T4模版，T4模版所需要的所有程序集引用必須明確的在模版中使用程序集執行引用才可以。
  3. T4模版自動加載以下程序集Microsoft.VisualStudio.TextTemplating.1*.dll、System.dll、WindowsBase.dll，如果用到了其它的程序集需要顯示的使用程序集添加引用才可以
  4. 可以使用 $(variableName) 語法引用 Visual Studio 或 MSBuild 變量（如 $(SolutionDir)），以及使用 %VariableName% 來引用環境變量。介紹幾個常用的$(variableName) 變量：

　　　　$(SolutionDir):當前項目所在解決方案目錄

　　　　$(ProjectDir):當前項目所在目錄

　　　　$(TargetPath):當前項目編譯輸出文件絕對路徑

　　　　$(TargetDir):當前項目編譯輸出目錄，即web項目的Bin目錄，控制臺、類庫項目bin目錄下的debug或release目錄(取決於當前的編譯模式)

　　　　舉個例子：比如我們在D盤根目錄建立了一個控制臺項目TestConsole，解決方案目錄為D:\LzrabbitRabbit，項目目錄為
　　　　D:\LzrabbitRabbit\TestConsole，那麽此時在Debug編譯模式下
　　　　$(SolutionDir)的值為D:\LzrabbitRabbit
　　　　$(ProjectDir)的值為D:\LzrabbitRabbit\TestConsole
　　　　$(TargetPath)值為D:\LzrabbitRabbit\TestConsole\bin\Debug\TestConsole.exe
　　　　$(TargetDir)值為D:\LzrabbitRabbit\TestConsole\bin\Debug

  • T4 導入指令 
    <#@ import namespace="namespace" #>

    　在 Visual Studio T4 文本模板的代碼塊中，import 指令允許您在不提供完全限定名稱的情況下引用另一個命名空間中的元素。 它等效於 C# 中的 using 或 Visual Basic 中的 imports。默認已經導入了System命名空間的引用。

  • T4 包含指令 
    <#@ include file="filePath" #>
  1. filePath 可以是絕對的，或相對於當前模板文件。
  2. filePath 可以包括用“%”分隔的環境變量。 例如：<#@ include file="%HOMEPATH%\MyIncludeFile.t4" #>
  3. 所包含的文件的名稱不必使用擴展名“.tt”。可能需要針對包含的文件使用其他擴展名，例如，“.t4”。 這是因為，在您將 .tt 文件添加到項目中時，Visual Studio 會自動將其“自定義工具”屬性設置為 TextTemplatingFileGenerator。 您通常不希望單獨轉換包含的文件。
  4. 在處理時，被包含內容就像是包含文本模板的組成部分一樣。 不過，即使 include 指令後為普通文本塊和標準控制塊，也可以包括含有類功能塊 <#+...#> 的文件。
  5. 包含指令可以提高代碼復用率，比如我們可以將一些常用的程序集、命名空間引用放到一個文件裏，使用時僅需要引用下即可，省去了每次都要重新引用一遍的煩惱，如我們建立Reference.ttinclude文件，裏面包含了我們平時常用的程序集引用
    復制代碼 
    <#@ assembly name="System.Core.dll" #>
<#@ assembly name="System.Data.dll" #>
<#@ assembly name="System.Data.DataSetExtensions.dll" #>
<#@ assembly name="System.Xml.dll" #>
<#@ import namespace="System" #>
<#@ import namespace="System.Xml" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Data" #>
<#@ import namespace="System.Data.SqlClient" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ import namespace="System.IO" #>
    復制代碼

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

    <#@ include file="$(ProjectDir)Reference.ttinclude"  #>

文本塊

文本塊直接向輸出文件插入文本。 文本塊沒有特殊格式。 例如，下面的文本模板將生成一個包含單詞“Hello World!”的文本文件： 

<#@ output extension=".txt" #>
Hello World!

控制塊

控制塊是用於轉換模板的程序代碼節。 默認語言是 C#，但若要使用 Visual Basic，可以在文件開頭編寫以下指令： 

<#@ template language="VB" #>

用於編寫控制塊代碼的語言與生成的文本的語言無關。

標準控制塊

標準控制塊是生成輸出文件部件的程序代碼節。
在模板文件中，可以混合使用任意數量的文本塊和標準控制塊。 但是，不能在控制塊中嵌套控制塊。 每個標準控制塊都以 <# ... #> 符號分隔。
例如，如果使用下面的控制塊和文本塊，則輸出文件包含行“0, 1, 2, 3, 4 Hello!”：

復制代碼 
<#
    for(int i = 0; i < 4; i++)
    {
        Write(i + ", ");
    }
    Write("4");
#> Hello!
復制代碼

您可以交錯文本和代碼，而不必使用顯式 Write() 語句。 以下示例輸出“Hello!”四次：

復制代碼 
<#
    for(int i = 0; i < 4; i++)
    {
#>
Hello!
<#
    } 
#>
復制代碼

在代碼中，可以使用 Write(); 語句的位置都可以插入文本塊。

表達式控制塊

表達式控制塊計算表達式並將其轉換為字符串。 該字符串將插入到輸出文件中。
表達式控制塊以 <#= ... #> 符號分隔。
例如，如果使用下面的控制塊，則輸出文件包含“5”： 

<#= 2 + 3 #>

請註意，開始符號有三個字符“<#=”。
表達式可以包含作用域中的任何變量。 例如，下面的塊輸出數字行：

復制代碼 
<#@ output extension=".txt" #>
<#
    for(int i = 0; i < 4; i++)
    {
#>
This is hello number <#= i+1 #>: Hello!
<#
    } 
#>
復制代碼

類功能控制塊

類功能控制塊定義屬性、方法或不應包含在主轉換中的所有其他代碼。 類功能塊常用於編寫幫助器函數。 通常，類功能塊位於單獨的文件中，這樣它們可以包含在多個文本模板中。
類功能控制塊以 <#+ ... #> 符號分隔，可以簡單的認為<#+ ...#>定義的內容為我們的類文件
例如，下面的模板文件聲明並使用一個方法：

復制代碼 
<#@ output extension=".txt" #>
Squares:
<#
    for(int i = 0; i < 4; i++)
    {
#>
    The square of <#= i #> is <#= Square(i+1) #>.
<#
    } 
#>
That is the end of the list.
<#+   // Start of class feature block
private int Square(int i)
{
    return i*i;
}
#>
復制代碼

類功能必須編寫在文件末尾。 不過，即使 include 指令後跟標準塊和文本，也可以 <#@include#> 包含類功能的文件。
類功能塊可以包含文本塊
可以編寫生成文本的方法。 例如：
List of Squares:

復制代碼 
<#
   for(int i = 0; i < 4; i++)
   {  WriteSquareLine(i); }
#>
End of list.
<#+   // Class feature block
private void WriteSquareLine(int i)
{
#>
   The square of <#= i #> is <#= i*i #>.
<#   
}
#>
復制代碼

將文本生成方法放置在可供多個模板包含的單獨文件中，是非常有用的。

嗯，大概的基礎點應該就這些了，更多的自己去MSDNhttp://msdn.microsoft.com/zh-cn/library/bb126445詳細了解吧

　　這裏解釋點容易讓人困惑的地方，我們在T4模版裏面引用的程序集和那些命名空間都是利用T4生成代碼需要使用的，也就是T4模版要用的，和我們要生成的目標類毛關系都沒有，當初為搞清楚這點可是費了不精力。T4初看起來很復雜，其實稍微花些心思研究下，主要似乎把MSDN看懂還是很容易學會的，一旦掌握了受用無窮

T4模版引擎之基礎入門

相關推薦

T4模版引擎之基礎入門

如何 inf 添加引用 研究 變量 sta word lis ports 　　額，T4好陌生的名字，和NuGet一樣很悲催，不為世人所熟知，卻又在背後默默無聞的奉獻著，直到現在我們項目組的人除了我之外，其它人還是對其豪無興趣，基本上是連看一眼都懶得看

MyBatis之基礎入門

Mybatis介紹 　　 　　MyBatis是一個支援普通SQL查詢，儲存過程和高階對映的優秀持久層框架。MyBatis消除了幾乎所有的JDBC程式碼和引數的手工設定以及對結果集的檢索封裝。MyBatis可以使用簡單的XML或註解用於配置和原始對映，將介面和Java的

Qt入門之基礎篇 ( 二 ) ：Qt項目建立、編譯、運行和發布過程解析

qt 5 對話 讓我 進度 qmake ctr deploy 設定 設置 轉載請註明出處：CN_Simo。 題解： 　　本篇內容主講Qt應用從創建到發布的整個過程，旨在幫助讀者能夠快速走進Qt的世界。 　　本來計劃是講解Qt源碼靜態編譯，如此的話讀者可能並不能清楚地知

Qt入門之基礎篇 ( 一 ) ：Qt4及Qt5的下載與安裝

mingw ins 第3版 點擊 調試 但我 關系 構建 eas 轉載請註明出處：CN_Simo. 導語： Qt是一個跨平臺的C++圖形界面應用程序框架。它提供給開發者建立圖形用戶界面所需的功能，廣泛用於開發GUI程序，也可用於開發非GUI程序。Qt很容易擴展，並

EasyUI基礎入門之Pagination(分頁)

比例 tab 由於 名稱 script idt 分隔符 jquery show 前言 對於一些企業級的應用來說(非站點),頁面上最為基本的內容也就是表格和form了。對於類似於ERP這類系統來說數據記錄比較大,前端表格展示的時候必需得實現分頁功能了。恰巧

【11】 Express安裝入門與模版引擎ejs

scrip png js文件 是我 use 處理 ica direct 配置 前言 Express簡介和安裝 運行第一個基於express框架的Web 模版引擎 ejs express項目結構 express項目分析 app.set(name,value) app

T4模板：T4模板之基礎篇

教程 添加 介紹 9.png 輸出 com 明顯 gin ecif 一、回顧 上一篇文章 ——T4模板之菜菜鳥篇，我們囫圇吞棗的創建了與“T4模板”有關的文件。在創建各個文件的這一個過程中，我們對於T4模板有了那麽丁點的認識。現在就帶著之前的那些問題，正式的邁入對“T4模板

Python學習之路 - 基礎入門

rdquo 下載 asd 64位 pyqt 最大 視頻網站 必備 真的 本系列文章使用的Python版本為3.6.2 使用開發工具為Pycharm2017 一、Python介紹 Python的創始人為吉多·範羅蘇姆（Guido van Rossum

python學習_day58_前端基礎之jQuery入門1

基本 兼容多瀏覽器 python jquery入門 選擇 eight ges span 偶數 一、jQuery介紹 　　jQuery是一個輕量級的、兼容多瀏覽器的JavaScript庫。使用戶能夠更方便地處理HTML Document、Events、實現動畫效果、方便地進行

前端基礎之jQuery入門 01

隔行變色 三方 sel () 層級選擇器 aps not 切換 jquer jQuery介紹 jQuery是一個輕量級的、兼容多瀏覽器的JavaScript庫。 jQuery使用戶能夠更方便地處理HTML Document、Events、實現動畫效果、方便地進行Ajax交

08-Linux基礎入門（六）-文件和目錄的屬性及權限之文件類型、文件擴展名及文件權限基礎

ins tmp first 串口 .py 都是 公眾平臺 cond .com 一、Linux中的文件類型在Linux系統中，可以說一切（包括目錄、普通文件、設備文件等）皆為文件。文件類型包含有普通文件、目錄、字符設備文件、設備文件、符號鏈接文件、管道文件等等，當執行ls

10-Linux基礎入門（八）-文件和目錄的屬性及權限之用戶與組和時間戳基礎

log 信息 p s center 新浪 shell 使用 自己的 用戶配置 一、概述Linux是一個多用戶、多任務的操作系統，對於Linux系統來說，由於角色不同，權限和所完成的任務也不同。用戶的角色是通過UID和GID識別的，用戶的UID就相當於我們的身份證一樣，用戶名

MySQL基礎入門學習【14】存儲引擎

nsis ont 過程 關系 ali 余額 bili 事務 atom 查看數據表的創建命令： 【存儲引擎】: MySQL可以將數據以不同的奇數存儲在文件（內存）中，這種技術就成為存儲引擎 　　　　　　 每一種存儲引擎都使用了不同的存儲機制、索引技巧、鎖定水平，最

Redis 入門之基礎

我們 -- git 數量 stack ast www 基礎 技術分享 1.安裝 redis-windows redis服務端下載 redis客戶端下載 redis官網 redis中文網 1.1 Window下安裝 redis-server.exe redis.windo

Nodejs學習筆記（五）—Express安裝入門與模版引擎ejs

num routes 項目目錄 其中 bubuko 執行 ctrl+ ica 開發經驗 前言 　　前面也學習了一些Node.js的基本入門知道，現在開始進入Web開發的部分； 　　Node.js提供了http模塊，這個模塊中提供了一些底層接口，可以直接使用，但是直接開發網站

Web前端開發之HTML+CSS基礎入門(框架)

AR 網頁 html 表單提交 pos 部分加載 selected area pin HTML框架詳解與框架布局? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?? 1)什麽是框架 框架將瀏覽器劃分成不同的部分，每一部分加載不同的網頁，實現在同一

Web前端開發之HTML+CSS基礎入門(使用CSS樣式的方式)

AD 層疊樣 b前端開發 col In 基於 允許 ML 語言 1) HTML<!DOCTYPE> 聲明標簽 a.定義和用法 <!DOCTYPE> 聲明必須是 HTML 文檔的第一行，位於 <html> 標簽之前。 <!DOCTYP

JAVA攻城獅培養計劃之Java零基礎入門

集合 輸出流 java工具 基礎語 百度網 高效率 字符 包裝類 利用 百度網盤下載 步驟一、Java基礎知識 基礎語法、循環、數組、方法，這些知識是你進入研發世界的必備技能 步驟二、面向對象繼承、封裝、多態、玩轉面向對象，你一定聽說過“面向對象”，這是理解編程這件事最重要

Linux基礎入門之單用戶密碼修改03

分享圖片 基礎 .com log term color chroot bin alt 1.啟動系統，並在選擇第二個選項，按下e鍵進入編輯模式2.在Linux16 /vmlinuz的行末 編輯添加init=/sysroot/bin/sh 3.按Ctrl +x 啟動shell4

Java基礎入門五）之方法以及遞歸算法

存在 兼容 直接 elf 推薦 1.8 可讀性 do..while 方法體 一.方法 1.1 什麽是方法 java中的方法類似於其他語言中的函數 是一段用來完成特定功能的代碼片段 1.2 為什麽要聲明方法