T4实践 简单的代码生成器

最新推荐文章于 2020-12-28 13:46:43 发布
最新推荐文章于 2020-12-28 13:46:43 发布
阅读量8.9k 收藏 3
点赞数
分类专栏： C#.NET基础 文章标签： string c# assembly extension table import

一、T4简介

T4(Text Template Transformation Toolkit)在 Visual Studio 中，“T4 文本模板”是由一些文本块和控制逻辑组成的混合模板，它可以生成文本文件。 在 Visual C# 或 Visual Basic 中，控制逻辑编写为程序代码的片段。生成的文件可以是任何类型的文本，例如网页、资源文件或任何语言的程序源代码。

 


T4 文本模板有两种类型：

　　 1、运行时模板 　　可在应用程序中执行 运行时 T4 文本模板（“预处理过的”模板）以便生成文本字符串（通常作为其输出的一部分）。

　　若要创建运行时模板，请向您的项目中添加“已预处理的文本模板”文件。

　　另外，您还可以添加纯文本文件并将其“自定义工具”属性设置为“TextTemplatingFilePreprocessor”。

　　2、设计时模板

　　在 Visual Studio 中执行设计时 T4 文本模板，以便定义应用程序的部分源代码和其他资源。

　　通常，您可以使用读取单个输入文件或数据库中的数据的多个模板，并生成一些 .cs、.vb 或其他源文件。

　　每个模板都生成一个文件。 在 Visual Studio 或 MSBuild 内执行它们。

　　若要创建设计时模板，请向您的项目中添加“文本模板”文件。 另外，您还可以添加纯文本文件并将其“自定义工具”属性设置为“TextTemplatingFileGenerator”。


二、T4例子--HelloWorld

 最简单的HelloWorld，通过此例子，可以看到T4的基本结构

复制代码 
<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".cs" #>
<#@ import namespace="System" #>
<#@ import namespace="System.Collections.Generic" #>

using System;

namespace Test
{
    public class HelloWorld
    { 
        public static void Main(string[] args)
        {
            <# 
            List<Person> people = GetPersonList();
            foreach(Person p in people)
            {
            #>
            Console.WriteLine("Hello {0},Welcome to T4 World!","<#= p.Name #>");
            <#}
            #>
        }
    }
}

<#+
//类
public class Person
{
    ///名称
    public string Name{ get; set; }

    public Person(string name)
    {
        this.Name = name;
    }
}
//初始化众人
public List<Person> GetPersonList()
{
    List<Person> people = new List<Person>();

    Person p1 = new Person("Tom");
    Person p2 = new Person("Jim");
    Person p3 = new Person("Lucy");

    people.Add(p1);
    people.Add(p2);
    people.Add(p3);

    return people;
}

#>
复制代码


生成的代码：

复制代码 
using System;

namespace Test
{
    public class HelloWorld
    {
        public static void Main(string[] args)
        {
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Tom");
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Jim");
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Lucy");
        }
    }
}
复制代码


三、T4模板的基本结构

代码块的总体分类，就是两种：文本、程序脚本。

我感觉这样分类就够了，跟我们用c#写代码生成原理差不多。也是又C#代码和文本组成的。

文本：就是需要生成的文本

程序脚本：内部执行，最终生成想要的文本。T4中<# #>中的部分都属于程序脚本内容。

 为了细分语法，方便大家更好的理解，用“块”（Block）来表示构成T4模板的基本单元，它们基本上可以分成5类：指令块（Directive Block）、文本块（Text Block）、代码语句块（Statement Block）、表达式块（Expression Block）和类特性块（Class Feature Block）。

1、指令块（Directive Block）

和ASP.NET页面的指令一样，它们出现在文件头，通过<#@…#>表示。其中<#@ template …#>指令是必须的，用于定义模板的基本属性，比如编程语言、基于的文化、是否支持调式等等。比较常用的指令还包括用于程序集引用的<#@ assembly…#>，用于导入命名空间的<#@ import…#>等等。

指令通常是模板文件或包含的文件中的第一个元素。不应将它们放置在代码块 <#...#> 内，也不应放置在类功能块 <#+...#> 之后。

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"#>

2、文本块（Text Block）

文本块就是直接原样输出的静态文本，不需要添加任何的标签。

3、代码语句块（Statement Block）

代码语句块通过<#Statement#>的形式表示，中间是一段通过相应编程语言编写的程序调用，我们可以通过代码语句快控制文本转化的流程。在上面的代码中，我们通过代码语句块实现对一个数组进行遍历，输出重复的Console.WriteLine("Hello {0},Welcome to T4 World!","<#= p.Name #>");语句。

4、表达式块（Expression Block）

表达式块以<#=Expression#>的形式表示，通过它之际上动态的解析的字符串表达内嵌到输出的文本中。比如在上面的foreach循环中，每次迭代输出的人名就是通过表达式块的形式定义的（<#=  p.Name #>）

5、类特性块（Class Feature Block）

如果文本转化需要一些比较复杂的逻辑，我们需要写在一个单独的辅助方法中，甚至是定义一些单独的类，我们就是将它们定义在类特性块中。类特性块的表现形式为<#+ FeatureCode #>，对于Hello World模板，得到人名列表的GetPersonList方法就定义在类特性块中。

　使用设计时 T4 文本模板，您可以在 Visual Studio 项目中生成程序代码和其他文件。 通常，您编写一些模板，以便它们根据来自模型的数据来改变所生成的代码。 模型是包含有关应用程序要求的关键信息的文件或数据库。像一些常用的框架，基本都是根据数据库模型来生成代码框架的。

一、具体步骤

1、新建项目名为：T4Sample，添加新项，选择“文本模板”即可创建设计时模板

模板属性，请确认：

自定义工具 =

TextTemplatingFileGenerator

生成操作 =

无

打开模板，默认只有两行语句

<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".txt" #>


2、修改模板，依然以HelloWorld为例

复制代码 
<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".cs" #>

<#@ import namespace="System" #>
<#@ import namespace="System.Collections.Generic" #>

using System;

namespace Test
{
    public class HelloWorld
    { 
        public static void Main(string[] args)
        {
            <# 
            List<Person> people = GetPersonList();
            foreach(Person p in people)
            {
            #>
            Console.WriteLine("Hello {0},Welcome to T4 World!","<#= p.Name #>");
            <#}
            #>
        }
    }
}

<#+
//类
public class Person
{
    ///名称
    public string Name{ get; set; }

    public Person(string name)
    {
        this.Name = name;
    }
}
//初始化众人
public List<Person> GetPersonList()
{
    List<Person> people = new List<Person>();

    Person p1 = new Person("Tom");
    Person p2 = new Person("Jim");
    Person p3 = new Person("Lucy");

    people.Add(p1);
    people.Add(p2);
    people.Add(p3);

    return people;
}

#>
复制代码


3、生成代码，可通过以下方式

  • 保存
  • 编辑模板，然后将焦点更改到其他 Visual Studio 窗口
  • 右击模板文件，选择“运行自定义工具”
  • 在“解决方案资源管理器”工具栏中单击“转换所有模板”。 这将转换 Visual Studio 解决方案中的所有模板。

生成代码如下：

复制代码 
using System;

namespace Test
{
    public class HelloWorld
    {
        public static void Main(string[] args)
        {
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Tom");
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Jim");
            Console.WriteLine("Hello {0},Welcome to T4 World!", "Lucy");
        }
    }
}
复制代码


二、模板指令

首先了解最重要的指令块，在以后复杂的模板编写中，将会经常用到。

其实T4模板就是C#代码（当然还有VB）与文本的组合，一些逻辑代码就跟写C#代码一样。下一章将给出具体如何写T4模板。

C#代码与T4不同，就是引用、调试、输出等方面，而T4中最重要的指令Template ，就包含这些不同。

所以这里特别重点强调下指令Template，方便在以后复杂的T4模板编写中，能够得心应手。

使用 Template 指令

 

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

[compilerOptions="options"] #>


template 指令有多个特性，通过这些特性可以指定转换的不同方面。 所有特性都是可选的。

1、compilerOptions 特性

示例：

    compilerOptions="optimize+"
有效值：

    任何有效的编译器选项。

在模板已经转换为 Visual C# 或 Visual Basic 并且生成的代码已编译时会应用这些选项。


2、culture 特性

示例：

    culture="de-CH"
有效值：

    ""，不变的区域性，它是默认值。

    表示为 xx-XX 形式字符串的区域性。 例如：en-US、ja-JP、de-CH、de-DE。

Culture 特性指定将表达式块转换为文本时要使用的区域性。


3、debug 特性

示例：

    debug="true"

有效值：

    true, false. 默认值为 false。

debug 特性指定是否启用调试。 如果是 true，则中间代码文件将包含使调试器能够识别模板中中断或异常发生位置的信息。 对于

设计时模板，中间代码文件将写入您的 %TEMP% 目录。

若要在模板执行的特定点启动调试器，请插入对 Launch 的调用。 若要在后续的点处中断执行，请插入对 Break 的调用。

复制代码 
<#@ template debug="true" language="C#" #>
<#@ output extension=".txt" #>
Output something.
<#
 // Break here:
 System.Diagnostics.Debugger.Launch();  
#>
Output more.
<#
 // Break here also:
 System.Diagnostics.Debugger.Break();  
#>
Output more.
复制代码


4、hostspecific 特性

有效值：

    true, false. 默认值为 false。

如果将此特性的值设置为 true，则会将名为 Host 的属性添加到由文本模板生成的类中。 该属性是对转换引擎的宿主的引用，并声

明为 Microsoft.VisualStudio.TextTemplating.ITextTemplatingEngineHost。 如果已经定义了自定义宿主，则可以将其转换为自

定义宿主类型。

因为此属性的类型取决于宿主的类型，所以仅当编写只适用于特定宿主的文本模板时才有用。

当 hostspecific 为 true，而且正在使用 Visual Studio 时，可以将 this.Host 强制转换为 IServiceProvider，以访问 Visual

Studio 功能。 还可以使用 Host.ResolvePath(filename) 来获得项目中文件的绝对路径。


5、language 特性

示例：

    language="VB"
有效值：

    C#（默认值）

    VB

    （值 VBv3.5 和 C#v3.5 在此版本中已过时，但是会解释为 VB 和 C#。）

language 特性指定要用于语句和表达式块中的源代码的语言（Visual Basic 或 Visual C#）。 从中生成输出的中间代码文件将使

用此语言。 此语言与您的模板生成的语言无关，它可以是任何类型的文本。


6、inherits 特性

可以指定模板的程序代码可以继承自另一个类，这个类也可以从文本模板生成。

 

如何快速高效的写出高质量的T4模板呢？

一、总结：先验证C#代码，然后转T4模板！

通过实践，总结如下：先验证C#代码，然后转T4模板！
因为T4模板难以调试，以后会就调试，专门拿一张来介绍。T4模板编写的实质就是脚本代码和文本。脚本代码通常就是C#和VB.Net。主要逻辑都在脚本代码中。而C#代码调试要简单方便的多。所以，在编写T4模板的时候，我们完全，可以先写C#代码，然后再修改为T4模板。需要修改的地方，只是将C#放在<##>标记中，一些引用需要修改，而模板还有个好处，就是不用定义类型，直接添加默认函数或者属性

本文将结合实际例子，来进行说明。

二、实例：代码生成器

该实例，就是我们通常见过的，模型代码生成器，根据数据模型生成代码框架，如模型层、数据访问层等。

本实例先根据数据表，生存模型层代码。这是一个简单实例，如果有功夫，您可以根据这个原理写出自己的代码生成框架。

三、具体步骤：

1、预置数据

复制代码 
--创建库
CREATE DATABASE TestDB


--创建表
CREATE TABLE PersonInfo
(
    ID INT PRIMARY KEY NOT NULL,
    NAME nvarchar(50) NOT NULL,
    Company NVARCHAR(50) NULL,
    Job NVARCHAR(20) NULL
)
复制代码

2、写C#代码，并验证通过。可用Console程序验证

模型管理器：主要实现，数据访问、获取表结构

复制代码 
using System;
using System.Data.SqlClient;
using System.Data;

namespace T4_3FiledGenerator
{
    public class ModelManager
    {
        /// <summary>
        /// 数据库连接字符串
        /// </summary>
        private const string CONNECTION_STRING= "server=localhost;database=testDB;uid=sa;pwd=ufsoft;";
        /// <summary>
        /// 用户信息表名
        /// </summary>
        private const string PERSONINFO_TABLE_NAME = "PersonInfo";
        /// <summary>
        /// 根据表名查询表结构信息
        /// </summary>
        private const string SELECT_SCHEMA_BY_TABLE_NAME = @"SELECT  TABLE_NAME AS TableName  ,
                                                                    ORDINAL_POSITION AS ColumnID ,
                                                                    COLUMN_NAME AS ColumnName ,
                                                                    DATA_TYPE AS DataType ,
                                                                    CASE WHEN IS_NULLABLE = 'NO' THEN 'false'
                                                                         ELSE 'true'
                                                                    END AS IsNullable
                                                            FROM    INFORMATION_SCHEMA.COLUMNS AS A
                                                                    LEFT JOIN sysobjects AS B ON A.TABLE_NAME = B.name
                                                            WHERE   A.TABLE_NAME = '{0}'";

        /// <summary>
        /// 获得数据连接
        /// </summary>
        /// <returns></returns>
        private SqlConnection GetConnection()
        {
            return new SqlConnection(CONNECTION_STRING);
        }
        /// <summary>
        /// 释放连接
        /// </summary>
        /// <param name="con"></param>
        private void ReleaseConnection(SqlConnection con)
        {
            if (con != null)
            {
                if (con.State == ConnectionState.Open)
                {
                    con.Close();
                }
            }
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="tableName"></param>
        public DataTable GetTableSchema(string tableName)
        {
            DataTable dt;
            using (SqlConnection con = GetConnection())
            {
                con.Open();

                SqlCommand cmd = con.CreateCommand();
                cmd.CommandText = string.Format(SELECT_SCHEMA_BY_TABLE_NAME,tableName);
                cmd.CommandType = CommandType.Text;

                SqlDataAdapter adapter = new SqlDataAdapter(cmd);
                DataSet ds = new DataSet(); 
                adapter.Fill(ds);
                dt = ds.Tables[0];
            }

            return dt;
        }
        /// <summary>
        /// 
        /// </summary>
        public void Generate()
        {
            DataTable table = GetTableSchema(PERSONINFO_TABLE_NAME);

            if (table != null && table.Rows.Count > 0)
            {
                foreach (DataRow row in table.Rows)
                {
                    Console.WriteLine("public class {0}", row["TableName"]);
                    Console.WriteLine("public {0} {1}", TransFromSqlType(row["DataType"].ToString()), row["ColumnName"]);
                }
            }
        }
        /// <summary>
        /// SQL
        /// </summary>
        /// <param name="type"></param>
        /// <returns></returns>
        public string TransFromSqlType(string type)
        {
            if (string.IsNullOrEmpty(type))
            {
                return string.Empty;
            }

            if (string.Equals(type, "int", StringComparison.OrdinalIgnoreCase))
            {
                return "int";
            }
            else if (string.Equals(type, "nvarchar", StringComparison.OrdinalIgnoreCase))
            {
                return "string";
            }

            return "string";
        }

    }
}
复制代码

测试程序：

复制代码 
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace T4_3FiledGenerator
{
    class Program
    {
        static void Main(string[] args)
        {
            ModelManager manager = new ModelManager();
            manager.Generate();
        }
    }
}
复制代码


3、C#代码转换成T4

3.1 添加引用，在C#中一般都是直接用using，在这里，需要改为import方式，如：<#@ import namespace="System.Data" #>
如果有些dll，需要添加引用，则需要assembly，如：<#@ assembly name="System.Data" #>。

对于程序集的加载，通常有两种情况，

（1）如果C#自带的，则直接用dll的名称即可，

（2）如果实自定义DLL文件，需要添加全路径，这是最简单的方法，还有其他一些方法，这里暂且不讨论。

3.2 将写成的C#代码，放在<#+ #>标签中，一般放置在T4模板最后

3.3 调用C#的方法，初始化变量

3.4 编写T4文本模板

3.5 对模板中的一些变量，调用2.3初始化的变量进行赋值

具体的T4代码如下：

复制代码 
<#@ template debug="false" hostspecific="false" language="C#" #>
<#@ output extension=".cs" #>
<#@ assembly name="System.Data" #>
<#@ assembly name="System.Xml" #>
<#@ import namespace="System" #>
<#@ import namespace="System.Xml" #>
<#@ import namespace="System.Data" #>
<#@ import namespace="System.Data.SqlClient" #>
<# 
ModelManager manager = new ModelManager();
string tableName = "PersonInfo";
DataTable table= manager.GetTableSchema(tableName);
#>
using System;

namespace Model
{
    public class <#= tableName #>
    {
        <#
        foreach(DataRow row in table.Rows)
        {
        #>
        public <#= manager.TransFromSqlType(row["DataType"].ToString())#> <#=row["ColumnName"]#>{ get; set; }

        <#}
        #>
    }
}

<#+
    public class ModelManager
    {
        /// <summary>
        /// 数据库连接字符串
        /// </summary>
        private const string CONNECTION_STRING= "server=localhost;database=testDB;uid=sa;pwd=ufsoft;";
        /// <summary>
        /// 用户信息表名
        /// </summary>
        private const string PERSONINFO_TABLE_NAME = "PersonInfo";
        /// <summary>
        /// 根据表名查询表结构信息
        /// </summary>
        private const string SELECT_SCHEMA_BY_TABLE_NAME = @"SELECT  TABLE_NAME AS TableName  ,
                                                                    ORDINAL_POSITION AS ColumnID ,
                                                                    COLUMN_NAME AS ColumnName ,
                                                                    DATA_TYPE AS DataType ,
                                                                    CASE WHEN IS_NULLABLE = 'NO' THEN 'false'
                                                                         ELSE 'true'
                                                                    END AS IsNullable
                                                            FROM    INFORMATION_SCHEMA.COLUMNS AS A
                                                                    LEFT JOIN sysobjects AS B ON A.TABLE_NAME = B.name
                                                            WHERE   A.TABLE_NAME = '{0}'";

        /// <summary>
        /// 获得数据连接
        /// </summary>
        /// <returns></returns>
        private SqlConnection GetConnection()
        {
            return new SqlConnection(CONNECTION_STRING);
        }
        /// <summary>
        /// 释放连接
        /// </summary>
        /// <param name="con"></param>
        private void ReleaseConnection(SqlConnection con)
        {
            if (con != null)
            {
                if (con.State == ConnectionState.Open)
                {
                    con.Close();
                }
            }
        }

        /// <summary>
        /// 
        /// </summary>
        /// <param name="tableName"></param>
        public DataTable GetTableSchema(string tableName)
        {
            DataTable dt;
            using (SqlConnection con = GetConnection())
            {
                con.Open();

                SqlCommand cmd = con.CreateCommand();
                cmd.CommandText = string.Format(SELECT_SCHEMA_BY_TABLE_NAME,tableName);
                cmd.CommandType = CommandType.Text;

                SqlDataAdapter adapter = new SqlDataAdapter(cmd);
                DataSet ds = new DataSet(); 
                adapter.Fill(ds);
                dt = ds.Tables[0];
            }

            return dt;
        }
        /// <summary>
        /// 
        /// </summary>
        public void Generate()
        {
            DataTable table = GetTableSchema(PERSONINFO_TABLE_NAME);

            if (table != null && table.Rows.Count > 0)
            {
                foreach (DataRow row in table.Rows)
                {
                    Console.WriteLine("public class {0}", row["TableName"]);
                    Console.WriteLine("public {0} {1}", TransFromSqlType(row["DataType"].ToString()), row["ColumnName"]);
                }
            }
        }
        /// <summary>
        /// SQL
        /// </summary>
        /// <param name="type"></param>
        /// <returns></returns>
        public string TransFromSqlType(string type)
        {
            if (string.IsNullOrEmpty(type))
            {
                return string.Empty;
            }

            if (string.Equals(type, "int", StringComparison.OrdinalIgnoreCase))
            {
                return "int";
            }
            else if (string.Equals(type, "nvarchar", StringComparison.OrdinalIgnoreCase))
            {
                return "string";
            }

            return "string";
        }

    }
#>
复制代码


4、生成代码并调试修改。

　　其实转过来时，出现错误的几率已经很少，比较难调的就是某些组件的引用。

5、结果，T4模板生成的代码

复制代码 
using System;

namespace Model
{
    public class PersonInfo
    {
        public int ID { get; set; }

        public string NAME { get; set; }

        public string Company { get; set; }

        public string Job { get; set; }

    }
}
复制代码

使用 Visual Studio 预处理过的文本模板，可以在运行时在应用程序中生成文本字符串。 执行应用程序的计算机不必具有 Visual Studio。 预处理过的模板有时称为“运行时文本模板”。每个模板都包含将显示在生成的字符串中的文本和程序代码的片段。 程序片段为字符串的可变部分提供值，还控制条件部分和重复部分。

创建运行时文本模板

一、具体步骤：

1、在解决方案资源管理器中，右击项目，指向“添加”，再单击“新建项”。


2、在“添加新项”对话框中，选择“预处理文本模板”。 （在 Visual Basic 中的“常用项\常规”下查看。）

3、键入模板文件的名称，如：MyWebPage

4、单击“添加”。

   将创建一个扩展名为 .tt 的新文件。 该文件的“自定义工具”属性设置为 TextTemplatingFilePreprocessor。与之前讲到的设计时模板不同。

　　设计时模板: TextTemplatingFileGenerator
　　运行时模板：TextTemplatingFilePreprocessor

　　模板转换：
　　当然设计时模板可以转为运行时模板，只要将该文件的“自定义工具”属性设置为 TextTemplatingFilePreprocessor即可。
　　但是运行时模板很多情况下不能转为设计时模板。后面的内容会帮我们揭开缘由。

二、实例--显示课程网页

在新建模板的同时，生成了模板的部分类。

一个是以模板名+code结尾：MyWebPageCode.cs，在这里我们可以声明模板需要的变量、方法。

这里我们需要设置课程集合。

复制代码 
    public partial class MyWebPage
    {
        private List<string> items;

        public List<string> Items
        {
            get { return items; }
            set { items = value; }
        }

        public MyWebPage(List<string> data) { this.items = data; }
    }
复制代码


另一个请展开 .tt 文件节点，此附属文件包含一个分部类，该类包含一个名为 TransformText() 的方法。这个方法中的内容会根据模板内容的变化而变化，其实就是模板代码转为C#代码。此方法可以从应用程序中调用。

修改模板：

复制代码 
<#@ template language="C#" #>
<html>
<body>
<h1>计算机课程</h2>
<table>
    <# foreach(string item in Items)
       { #>
         <tr><td>Course name : <#= item #> </td></tr>
    <# } #>
 </table>
 </body>
 </html>
复制代码


查看附属文件的部分类，方法：TransformText()

复制代码 
        public virtual string TransformText()
        {
            this.GenerationEnvironment = null;
            this.Write("<html>\r\n<body>\r\n<h1>计算机课程</h2>\r\n<table>\r\n    ");
            
            #line 6 "D:\Code\C#\UFIDA.U8.UAP.EntityGenerator\PreTemplateTest\MyWebPage.tt"
 foreach(string item in Items)
       { 
            
            #line default
            #line hidden
            this.Write("         <tr><td>Course name : ");
            
            #line 8 "D:\Code\C#\UFIDA.U8.UAP.EntityGenerator\PreTemplateTest\MyWebPage.tt"
            this.Write(this.ToStringHelper.ToStringWithCulture(item));
            
            #line default
            #line hidden
            this.Write(" </td></tr>\r\n    ");
            
            #line 9 "D:\Code\C#\UFIDA.U8.UAP.EntityGenerator\PreTemplateTest\MyWebPage.tt"
 } 
            
            #line default
            #line hidden
            this.Write(" </table>\r\n </body>\r\n </html>");
            return this.GenerationEnvironment.ToString();
        }
复制代码

程序调用，对模板变量赋值，并调用模板，输出文件。

复制代码 
        static void Main(string[] args)
        {
            List<string> items = new List<string>();
            items.Add("计算机基础");
            items.Add("数据库");
            items.Add("计算机网络");
            MyWebPage page = new MyWebPage(items);
            String pageContent = page.TransformText();
            //如果有汉字，需要设置编码格式
            System.IO.File.WriteAllText("outputPage.html", pageContent,Encoding.UTF8);
        }
复制代码

运行程序，生成模板：

生成的HTML

复制代码 
<html><body>
<h1>计算机课程</h2>
<table>
             <tr><td>Course name : 计算机基础 </td></tr>
             <tr><td>Course name : 数据库 </td></tr>
             <tr><td>Course name : 计算机网络 </td></tr>
     </table>
 </body></html>
复制代码

浏览器打开效果：


在运行时生成文本，若要在特定命名空间中放置已生成的类，请设置文本模板文件的“自定义工具命名空间”属性。

三、基本原理
由上述实例，我们已经基本了解了运行时模板的基本步骤，现在总结一下运行时模板的基本原理。

我们通常也通过C#输出文件，可能也要按照一定的格式来生成。其实这里的运行时模板，就是这样一个工具，设定好模板后，然后VS自动转为C#代码，在部分类中TransformText()方法，我们可以找到踪迹。

运行时模板，简单的说就是可视化的C#代码生成器。

运行时模板，提供了可视化功能，将夹杂在C#代码中的模板代码拿出来，让我们更加直观的看到模板的真实样子。方便进行修改和维护。

运行时模板就好比C#代码，比起设计时模板，方便跟踪调试。

四、源码下载

点击下载


原文http://www.cnblogs.com/yank/archive/2012/02/28/2352507.html


dz45693
关注
  • 0
    点赞
  • 踩
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
T4模板生成器案例
hangyejiadao的专栏
12-27 571
<# CodeGenerationTools code=new CodeGenerationTools(this); MetadataLoader loader=new MetadataLoader(this); CodeRegion region=new CodeRegion(this,1); MetadataTools ef=new MetadataTools(this); string i
t4模板生成html,强大的代码生成器——T4模板
weixin_35890173的博客
07-02 445
T4 Editor工具下载地址tangible T4 Editor 2.5.0 plus modeling tools for VS 2019https://marketplace.visualstudio.com/items?itemName=tangibleengineeringGmbH.tangibleT4Editor2019在vs2019安装后代码背景竟然变成了灰色，完全看不清楚。在工具—...
T4生成工具
09-22
VS提供的“文本模板”（俗称T4）功能，是一个较好的代码生成解决方案。要添加一个实体类型，只要把实体类型定义好，然后运行一下定义好的T4模板，就可以自动生成相应的类文件。T4Toolbox是生成的有效工具。
NFine_MSSQL_T4_代码生成器.rar
08-23
T4_代码生成器
T4代码生成器
05-15
1.用vs打开保存一次就可以生成（vs2010及以上版本）cs代码 2.生成代码的命名规范、样式喜好等都可以根据自己的需要自行修改 3.可扩展性强，目前支持oracle和sqlserver两种数据库来生成Model、BLL和DAL代码
T4模板来生成代码
07-31
T4模板是Visual Studio中的一种文本转换工具，它允许开发者编写动态代码生成脚本，极大地提高了开发效率。在软件开发中，特别是在数据访问层，我们经常需要为数据库模型创建对应的实体类（model）以及对应的仓储接口...
C#编写代码生成器源码
04-04
在IT行业中，代码生成器是一种非常实用的工具，它能够帮助开发者快速地生成常见的、重复性的代码，提高开发效率并减少错误。C#编写代码生成器源码是针对C#编程语言的一种定制化解决方案，利用Visual Studio 2010进行...
.NET代码生成器.NET代码生成器
09-05
《.NET代码生成器——高效开发的利器》 在软件开发过程中，代码生成器是一种能够自动根据特定模板或设计模式自动生成源代码的...正确地使用代码生成器，可以在遵循最佳实践的同时，让开发者更专注于创造性的编程工作。
代码生成器
11-27
【代码生成器】是一种工具，它能够自动化地创建软件项目的部分或全部代码，极大地提高了开发效率，降低了出错的可能性。在IT行业中，特别是在C#和ASP.NET开发领域，代码生成器是开发人员的重要助手，尤其在构建三层...
代码生成器，C#代码生成器
08-27
【代码生成器与C#代码生成器】 代码生成器是一种工具，它能够自动化地创建代码，减少程序员手动编写重复性代码的工作量。...通过实践和探索，开发者能够熟练掌握代码生成器，将其作为提升工作效率的强大工具。
CodeGenerator-T4模板代码生成器
01-14
CodeGenerator 使用T4模板从数据库生成实体/MAP 使用方法如下: 1.修改CodeGenerator.exe.config中的text连接字串并保存 2.打开CodeGenerator.exe 3.选择数据库 4.选择需要生成的表 5.选择对应的模板(选中模板后点VIEW可以打开模板进行查看/编辑) 模板是T4模板，置于Templete文件夹下，程序运行时会自动把此目录下的所有T4文件读出来. 6.点TEST查看根据第一个模板生成的效果 7.设置命名参数/数据表前缀(设置后前缀会在生成类名时去掉)/输出路径(默认当前程序下的OUTPUT文件夹) 8.点击Create进行生成。生成的文件会放在以在OUTPUT以模板名命名的文件夹中。 如果对此程序有意见与建议，欢迎向我提出:38677446
T4模板——一个神奇的代码生成器
weixin_30706691的博客
08-12 98
　　利用T4模板，可以很方便的从数据库映射成Model模型，相当于动软等功效。但动软是可以直接生成三层，抽象工厂的，T4没那么牛叉，所以我们一般只用作生成Modle或者Server等指定方法了。 废话少说，切入正题： 下面我将讲解的有两部分，一部分是根据T4将方法属性等生成到一个类里面，另一个是分配生成到不同类里面。 一.根据T4将方法生成到一个类里面 代码...
t4b代码生成_修改的T4代码生成器(续)
weixin_39579726的博客
12-20 103
最近一段时间，我利用业余时间在做一个基于客户公司风格的代码生成器，这个代码生成器在之前的文章中稍微介绍过(修改的T4代码生成器)，我并不是白手起家，而是参考了一们园友的作品。原作品的特点：１：基于WPF。比起传统的WinForm来讲，wpf在用户体验性上有很大的优势。优点一：能够比较容易的实现基于Visual风格的界面。这让使用者会比较熟悉，不会花太多时间去了解如何使用。优点二：自由拖拽UI元素比...
T4代码生成器Kalman Studio发布
weixin_34224941的博客
10-25 74
修改了以前的一些小BUG 下载地址 http://www.cnblogs.com/lingyun_k/archive/2010/05/08/1730771.html      
T4代码自动生成
Tomato的博客
12-28 530
@Tomato Excel + c# + sqlserver代码自动生成 目录 文章目录介紹方法1方法2 介紹 需求：Excel数据库设计 效果：自动生成sqlserver：数据库，代码：Model、Repository、Service、WebApi 固定常用的5个方法 方法1 c# NPOI获取Excel信息 c# 通过Excel信息 连接数据库新建表 c# 通过Excel信息 循环生成Model、Repository、Service、WebApi代码 方法2 c# NPOI获取
一个简易版的T4代码生成"框架"
weixin_34238633的博客
02-20 173
对于企业开发来说，代码生成在某种意义上可以极大地提高开发效率和质量。在众多代码生成方案来说，T4是一个不错的选择，今天花了点时间写了一个简易版本的T4代码生成的“框架”，该框架仅仅是定义了一些基本的基类以及其他与VS集成相关功能的类型而已。[源代码从这里下载] 目录 一、T4模版的定义和代码文件的生成 二、TransformationContext与Transform...
整理DOTNET代码生成器 [转]
weixin_34326558的博客
12-21 1215
1:CodeSmith 一款人气很旺国外的基于模板的dotnet代码生成器官方网站:http://www.codesmithtools.com官方论坛：http://forum.codesmithtools.com/default.aspx 版权...
C# 通过T4自动生成代码
weixin_30466953的博客
10-16 355
通过T4模板生成代码，运行时实现 关键代码段：Host using Microsoft.VisualStudio.TextTemplating; using System; using System.CodeDom.Compiler; using System.Collections.Generic; using System.IO; using System.Linq; ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值