T4文本模板

<#...#> 可以包含语句

<#=...#>  用于表达式，提供“输出”操作

<#+ ...> 使用类功能控制块向文本模板添加方法、属性、字段，必须作为文件中最后一个块显示

assembly 指令使指定的程序集可供模板代码使用，方式与 Visual Studio 项目中的“引用”部分相同。 您无需包括对 System.dll 的引用，它是自动引用的。 import 指令允许您使用类型而不使用其完全限定名，方式与普通程序文件中的 using 指令相同

若要从相对于文本模板的位置加载文件，可以使用 this.Host.ResolvePath()。 若要使用 this.Host，您必须在 template 中设置 hostspecific="true"，还可以使用 this.Host.TemplateFile，它标识当前模板文件的名称。

如果已安装 Visual Studio 可视化和建模 SDK，则可以在每次执行生成时自动转换所有模板。 为此，可在文本编辑器中编辑项目文件（.csproj 或 .vbproj），然后在文件末尾附近（其他任何<import> 语句之后）添加以下行：

<Import Project="$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v11.0\TextTemplating\Microsoft.TextTemplating.targets" />
<PropertyGroup>
   <TransformOnBuild>true</TransformOnBuild>
   <!-- Other properties can be inserted here -->
</PropertyGroup>

若要在 Visual Studio 错误窗口中放置错误消息和警告消息，可以使用以下方法：

<#@ template debug="false" hostspecific="true" language="C#" #>
<#Error("An error message");#>
<#Warning("A warning message");#> 

类功能控制块是一个可以在其中定义辅助方法的块。 该块以 <#+...#> 分隔，并且必须作为文件中的最后一个块显示。

通过设置 <#@template#> 指令的 hostspecific 特性，可以允许模板获取对 Visual Studio API 的访问。 模板可以使用此功能获取项目文件的位置，以避免在模板代码中使用绝对文件路径。

一个读取XML的例子：

 <?xml version="1.0" encoding="utf-8" ?>
 <catalog>
   <artist id ="Mike%20Nash" name="Mike Nash Quartet">
     <song id ="MikeNashJazzBeforeTeatime">Jazz Before Teatime</song>
     <song id ="MikeNashJazzAfterBreakfast">Jazz After Breakfast</song>
   </artist>
   <artist id ="Euan%20Garden" name="Euan Garden">
     <song id ="GardenScottishCountry">Scottish Country Garden</song>
   </artist>
 </catalog>

 <#@ template debug="false" hostspecific="true" language="C#" #>
 <#@ output extension=".cs" #>
 <#@ assembly name="System.Xml" #>
 <#@ assembly name="EnvDTE" #>
 <#@ import namespace="System.Xml" #>
 <#@ import namespace="System.Collections.Generic" #>
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Xml;
 namespace MyProject
 {
 <#
  // Map node name --> child name --> child node type
  Dictionary<string, Dictionary<string, XmlNodeType>> nodeTypes = new Dictionary<string, Dictionary<string, XmlNodeType>>();

  // The Visual Studio host, to get the local file path.
  EnvDTE.DTE dte = (EnvDTE.DTE) ((IServiceProvider) this.Host)
                        .GetService(typeof(EnvDTE.DTE));
  // Open the prototype document.
  XmlDocument doc = new XmlDocument();
  doc.Load(System.IO.Path.Combine(dte.ActiveDocument.Path, "exampleXml.xml"));
  // Inspect all the nodes in the document.
  // The example might contain many nodes of the same type,
  // so make a dictionary of node types and their children.
  foreach (XmlNode node in doc.SelectNodes("//*"))
  {
    Dictionary<string, XmlNodeType> subs = null;
    if (!nodeTypes.TryGetValue(node.Name, out subs))
    {
      subs = new Dictionary<string, XmlNodeType>();
      nodeTypes.Add(node.Name, subs);
    }
    foreach (XmlNode child in node.ChildNodes)
    {
      subs[child.Name] = child.NodeType;
    }
    foreach (XmlNode child in node.Attributes)
    {
      subs[child.Name] = child.NodeType;
    }
  }
  // Generate a class for each node type.
  foreach (string className in nodeTypes.Keys)
  {
     // Capitalize the first character of the name.
 #>
     partial class <#= UpperInitial(className) #>
     {
       private XmlNode thisNode;
       public <#= UpperInitial(className) #>(XmlNode node)
       { thisNode = node; }

 <#
     // Generate a property for each child.
     foreach (string childName in nodeTypes[className].Keys)
     {
       // Allow for different types of child.
       switch (nodeTypes[className][childName])
       {
          // Child nodes:
          case XmlNodeType.Element:
 #>
       public IEnumerable<<#=UpperInitial(childName)#>><#=UpperInitial(childName) #>
       {
         get
         {
            foreach (XmlNode node in
                 thisNode.SelectNodes("<#=childName#>"))
              yield return new <#=UpperInitial(childName)#>(node);
       } }
 <#
          break;
          // Child attributes:
          case XmlNodeType.Attribute:
 #>
       public string <#=childName #>
       { get { return thisNode.Attributes["<#=childName#>"].Value; } }
 <#
          break;
          // Plain text:
          case XmlNodeType.Text:
 #>
       public string Text  { get { return thisNode.InnerText; } }
 <#
          break;
        } // switch
      } // foreach class child
   // End of the generated class:
 #>
    }
 <#
  } // foreach class

    // Add a constructor for the root class
    // that accepts an XML filename.
    string rootClassName = doc.SelectSingleNode("*").Name;
 #>
    partial class <#= UpperInitial(rootClassName) #>
    {
       public <#= UpperInitial(rootClassName) #>(string fileName)
       {
         XmlDocument doc = new XmlDocument();
         doc.Load(fileName);
         thisNode = doc.SelectSingleNode("<#=rootClassName#>");
       }
    }
 }
 <#+
    private string UpperInitial(string name)
    {
       return name[].ToString().ToUpperInvariant() + name.Substring();
    }
 #>