T4文本模板转换过程

T4文本模板转换过程将文本模板文件作为输入，生成一个新的文本文件作为输出。 例如，可以使用文本模板生成 Visual Basic 或 C# 代码，还可以生成 HTML 报告。

有三个组件参与这一过程：引擎、宿主和指令处理器。 引擎对该过程进行控制(引擎与宿主和指令处理器交互)，以生成输出文件；宿主提供与环境的所有交互（如定位文件和程序集）; 指令处理器为文本模板添加功能(如从 xml 文件或数据库读取数据等)。

组件：

引擎：

引擎以字符串形式从宿主接收模板，而宿主处理在转换过程中所用的所有文件。 接下来，引擎请求宿主定位所有自定义指令处理器和环境中的其他方面。 然后，引擎编译和运行生成转换类。 引擎将生成的文本返回给宿主，宿主通常将该文本保存到文件中。

宿主：

宿主负责转换过程之外与环境有关的所有操作，包括：

1）查找引擎或指令处理器请求的文本和二进制文件。 宿主可以搜索目录和全局程序集缓存以查找程序集。 宿主可以为引擎查找自定义指令处理器代码。 宿主还可以查找并读取文本文件，然后以字符串形式返回其内容。

2）提供标准程序集和命名空间的列表，供引擎用于创建生成转换类。

3）提供引擎在编译和执行生成转换类时所用的应用程序域。 将使用独立应用程序域，以免宿主应用程序受到模板代码错误的影响。

4）写入生成的输出文件。

5）设置生成的输出文件的默认扩展名。

6）处理文本模板转换错误。 例如，宿主可以将错误显示在用户界面中，也可以将错误写入文件。 （在 Visual Studio 中，错误显示在“错误消息”窗口中。）

7）在用户调用了指令但未提供值时，提供必需的参数值。 指令处理器可以指定指令名称和参数，可以请求宿主提供默认值（如果有）。

指令和指令处理器：

指令是文本模板中的命令。 它向生成过程提供参数。 通常，指令定义模型或其他输入的源和类型，以及输出文件的文件扩展名等。

指令处理器可以处理一个或多个指令。 转换模板之前，必须安装能够处理模板中的指令的指令处理器。

有了基本的概念，我们看下面的Demo（在程序中动态执行T4模板）：

在程序中动态执行T4模板：

执行结果：

CustomTextTemplatingEngineHost.cs（自定义文本模板宿主‎）

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using Microsoft.VisualStudio.TextTemplating;

using System.CodeDom.Compiler;

using System.IO;

namespace CustomHost

{

    public class CustomTextTemplatingEngineHost : ITextTemplatingEngineHost, ITextTemplatingsessionHost

    {

        #region ITextTemplatingEngineHost

        internal string TemplateFileValue;

						
上一篇文章： POCO Controller 你这么厉害，ASP.NET vNext 知道吗？
下一篇文章： ajax请求跨域问题