T4模板生成代码入门1

一、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}”, “Xxx”)语句。 

4、表达式块（Expression Block）

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

5、类特性块（Class Feature Block）

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

成长，我们一起见证！

windows应用

T4模板生成代码入门1

摘要: T4(Text Template Transformation Toolkit)
在 Visual Studio 中，“T4 文本模板”是由一些文本块和控制逻辑组成的混合模板，它可以生成文本文件。 在 Visual C# 或 Visual Basic 中，控制逻辑编写为程序代码的片段。生成的文件可以是任何类型的文本，例如网页、资源文件或任何语言的程序源代码。
本文通过具体实例，来介绍T4的基本结构，对T4有个大概的了解。希望对初识T4的朋友有所帮助。阅读全文

posted @ 2012-02-14 09:48 停留的风 阅读(246) | 评论 (0) 编辑 |

vista破解----最新破解软件

摘要: 教你轻松破解vista，支持各种品牌的笔记本，各种版本的vista系统。最新破解软件如下： 
【1】vista自动激活工具(4.0综合版) 
【2】vistasp1_loader_3.0.0.1 
【3】Windows傻瓜破解注册阅读全文

posted @ 2008-06-02 01:50 停留的风 阅读(524) | 评论 (0) 编辑 |

激活vista遇到的问题

摘要: 激活Vista出现的问题 
Booting 'Windows Vista' 
acpi 
Vista Loader 2.1.2 
ACPI: Reclaim Memory not found! 
进不去系统，进不去安全模式，还不能重装系统阅读全文

posted @ 2008-05-04 10:05 停留的风 阅读(484) | 评论 (2) 编辑 |

自定义域名解析

摘要: Hosts在Windows中应用！ 
　　1.加快域名解析 
　　2.方便局域网用户 
　　3.屏蔽网站 
　　4.顺利连接系统阅读全文

posted @ 2008-03-06 10:27 停留的风 阅读(383) | 评论 (0) 编辑 |

能登陆QQ,打不开网页

摘要: first:将网络连接自动获得IP,修改为手动，并且填入备用DNS,很可能是域名解析的问题。【经验证】阅读全文

posted @ 2008-01-04 09:34 停留的风 阅读(1746) | 评论 (1) 编辑 |

.net附加工具

摘要: <1>Js压缩工具 
<2>CSS压缩工具阅读全文

posted @ 2007-12-11 14:05 停留的风 阅读(206) | 评论 (0) 编辑 |

Windows技巧荟萃

摘要: 各种Windows技巧 
<1>桌面图标文字背景透明方法 
<2>桌面上得图标都不见啦 
<3>找回“显示桌面”图标 
<4>如何将FAT32分区转换为NTFS分区？ 
<5>在Vista中打开命令行 
<6>激活Vista,出现问题 
具体信息：ACPI: Reclaim Memory not found! 
阅读全文

posted @ 2007-12-06 11:19 停留的风 阅读(143) | 评论 (0) 编辑 |

绝好的软件集合

摘要: 各种非常实用，功能强大的软件集合，可能好多您都没有用过，如果你真的需要找一个这样得软件，或许这里已经为您准备好啦。
<1>Total commander(全能文件管理工具)
<2>Recover My Files(强大数据恢复工具)
<3>Fantom CD(虚拟光驱)
<4>Symantec Antivirus(诺顿杀毒)10.0.2.2000.Final 简体中文企业版
<5>Virtual CD-ROM Control Panel是一款微软自己推出的虚拟光驱软件
<6>Acronis Disk Director Suite（磁盘管理大师）支持vista,可创建分区、压缩和扩展分区，还能扩大主分区
阅读全文

posted @ 2007-12-03 15:06 停留的风 阅读(139) | 评论 (0) 编辑 |