如何将字符串参数传递给t4模板

时间:2013-04-11 10:47:25

标签: c# string parameters t4 texttemplate

您好我正在尝试找到一种方法将普通字符串作为参数传递给文本模板。

这是我的模板代码,如果有人可以告诉我在c#中需要写什么来传递我的参数并创建类文件。那将是非常有帮助的,谢谢。

<#@ 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" #>
<#@ parameter name="namespacename" type="System.String" #>
<#@ parameter name="classname" type="System.String" #>
<#
this.OutputInfo.File(this.classname);
#>
namespace <#= this.namespacename #>
{
    using System;
    using System.Collections.Generic; 
    using System.Linq; 
    using System.Xml; 

    /// <summary>
    /// This class describes the data layer related to <#= this.classname #>.
    /// </summary>
    /// <history>
    ///   <change author=`Auto Generated` date=<#= DateTime.Now.ToString("dd/MM/yyyy") #>>Original Version</change>
    /// </history>
    public partial class <#= this.classname #> : DataObject
    {
        #region constructor

        /// <summary>
        /// A constructor which allows the base constructor to attempt to extract the connection string from the config file.
        /// </summary>
        public <#= this.classname #>() : base() {}

        /// <summary>
        /// A constructor which delegates to the base constructor to enable use of connection string.
        /// </summary>
        /// <param name='connectionstring`></param>
        public <#= this.classname #>(string connectionstring) : base(connectionstring) {}

        #endregion
    }
}

3 个答案:

答案 0 :(得分:13)

以下是传递参数的一种方法:

  1. 您必须创建TextTemplatingSession。
  2. 设置参数的会话字典。
  3. 使用该会话处理模板。
  4. 示例代码(将ResolvePath替换为您的tt文件的位置):

    <#@ template debug="true" hostspecific="true" language="C#" #>
    <#@ output extension=".txt" #>
    <#@ import namespace="System.IO" #>
    <#@ import namespace="Microsoft.VisualStudio.TextTemplating" #>
    <# 
    string templateFile = this.Host.ResolvePath("ClassGeneration.tt");
    string templateContent = File.ReadAllText(templateFile);
    
    TextTemplatingSession session = new TextTemplatingSession();
    session["namespacename"] = "MyNamespace1";
    session["classname"] = "MyClassName";
    
    var sessionHost = (ITextTemplatingSessionHost) this.Host;
    sessionHost.Session = session;
    
    Engine engine = new Engine();
    string generatedContent = engine.ProcessTemplate(templateContent, this.Host);
    
    this.Write(generatedContent);  #>
    

    我在Oleg Sych的博客上看到了这个example,这是t4的绝佳资源。

答案 1 :(得分:10)

这是一个有3年历史的问题,我不知道模板库已经发展了多少,以及我的问题解决方案是否适用于旧版本的Visual Studio和/或.NET等。我目前正在使用Visual Studio 2015和.NET 4.6.1。

摘要

使用“类功能控制块”将公共成员声明为模板的生成类,并在模板文本中引用这些公共成员。

实施例

在C#项目中选择Add New Item&gt;运行时文本模板&gt; “Salutation.tt”。您将获得一个带有以下默认声明的新.tt文件:

<#@ template language="C#" #>
<#@ assembly name="System.Core" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>

在声明下方输入您的模板文字:

My name is <#= Name #>.
<# if (RevealAge) { #>
I am <#= Age #> years old.
<# } #>

在.tt文件的末尾,将您的参数作为公共类成员添加到“类功能控制块”中。 此块必须转到文件末尾

<#+
public string Name { get; set; }
public int Age { get; set; }
public bool RevealAge = false;
#>

然后,例如,在控制台应用程序中,您可以按如下方式使用模板:

Console.Write(new Salutation
{
    Name = "Alice",
    Age = 35,
    RevealAge = false
}.TransformText());

Console.Write(new Salutation
{
    Name = "Bob",
    Age = 38,
    RevealAge = true
}.TransformText());

获得以下输出:

My name is Alice.
My name is Bob.
I am 38 years old.
Press any key to continue . . .

有关T4语法的详细信息,请参阅MSDN文章Writing a T4 Text Template

答案 2 :(得分:0)

还可以在处理模板内容之前将参数注入模板内容中。 为此,请在模板中添加<##>作为代码注入的占位符。

GenericClass.ttinclude

<#@ template language="C#" #>
<##>
namespace <#= Namespace #>
{
    public class <#= ClassName #> : IGeneric<<#= TypeParameter #>>
    {
        public <#= TypeParameter #> ReturnResult() => 1 + 3;
    }
}
<#+
    public string ClassName { get; set; }
    public string Namespace { get; set; }
    public string TypeParameter { get; set; }
#>

不添加用于导入其他模板(Generator.ttinclude)的通用模板:

<#@ import namespace="System.IO" #>
<#@ import namespace="System.Text" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ import namespace="Microsoft.VisualStudio.TextTemplating" #>
<#+
    public const string ParametersInjectionPattern = "<" + "#" + "#" + ">";

    public void Generate(string baseTemplatePath, IDictionary<string, string> parameters)
    {
        var template = File.ReadAllText(this.Host.ResolvePath(baseTemplatePath));

        template = template.Replace(ParametersInjectionPattern, GenerateParametersAssignmentControlBlock(parameters));

        this.Write(new Engine().ProcessTemplate(template, this.Host).Trim());
    }

    public string GenerateParametersAssignmentControlBlock(IDictionary<string, string> parameters)
    {
        var sb = new StringBuilder();
        sb.Append('<').Append('#').Append(' ');

        foreach (var parameter in parameters)
            sb.Append($"{parameter.Key} = {parameter.Value};");

        sb.Append(' ').Append('#').Append('>');
        return sb.ToString();
    }

    public string SurroundWithQuotes(string str)
    {
        return $"\"{str}\"";
    }

    public string GetTemplateName()
    {
        return Path.GetFileNameWithoutExtension(this.Host.TemplateFile).Replace(".Generated", "");
    }
#>

然后在任何特定模板中使用它,您可以在其中传递必要的参数(UInt64Class.Generated.tt):

<#@ template hostspecific="true" language="C#" #>
<#@ import namespace="System.Collections.Generic" #>
<#@ output extension=".cs" #>
<#@ include file="Generator.ttinclude" #>
<#
    var parameters = new Dictionary<string, string>()
    {
        { "Namespace", SurroundWithQuotes("T4GenericsExample") },
        { "ClassName", SurroundWithQuotes(GetTemplateName()) },
        { "TypeParameter", SurroundWithQuotes("System.UInt64") }
    };

    Generate("GenericClass.ttinclude", parameters);
#>

完整的示例可以在https://github.com/Konard/T4GenericsExample

中找到