t4-parameter-directive.md

title	description	ms.date	ms.topic	author	ms.author	manager	ms.subservice
T4 Parameter Directive	Learn that in Visual Studio, the parameter directive declares properties in your template code that are initialized from values passed in from the external context.	11/04/2016	reference	mgoertz-msft	mgoertz	mijacobs	modeling

T4 Parameter Directive

In a Visual Studio text template, the parameter directive declares properties in your template code that are initialized from values passed in from the external context. You can set these values if you write code that invokes text transformation.

Using the Parameter Directive

<#@ parameter type="Full.TypeName" name="ParameterName" #> 

The parameter directive declares properties in your template code that are initialized from values passed in from the external context. You can set these values if you write code that invokes text transformation. The values can be passed either in the Session dictionary, or in xref:System.Runtime.Remoting.Messaging.CallContext.

You can declare parameters of any remotable type. That is, the type must be declared with xref:System.SerializableAttribute, or it must derive from xref:System.MarshalByRefObject. This allows parameter values to be passed into the AppDomain in which the template is processed.

For example, you could write a text template with the following content:

<#@ template language="C#" #> <#@ parameter type="System.Int32" name="TimesToRepeat" #> <# for (int i = 0; i < TimesToRepeat; i++) { #> Line <#= i #> <# } #> 

Passing parameter values to a template

If you are writing a Visual Studio Extension such as a menu command or an event handler, you can process a template by using the text templating service:

// Get a service provider - how you do this depends on the context:IServiceProviderserviceProvider=dte;// or dslDiagram.Store, for example// Get the text template service:ITextTemplatingt4=serviceProvider.GetService(typeof(STextTemplating))asITextTemplating;ITextTemplatingSessionHosthost=t4asITextTemplatingSessionHost;// Create a Session in which to pass parameters:host.Session=host.CreateSession();// Add parameter values to the Session:session["TimesToRepeat"]=5;// Process a text template:stringresult=t4.ProcessTemplate("MyTemplateFile.t4",System.IO.File.ReadAllText("MyTemplateFile.t4"));

Passing values in the Call Context

You can alternatively pass values as logical data in xref:System.Runtime.Remoting.Messaging.CallContext.

The following example passes values by using both methods:

ITextTemplatingt4=this.Store.GetService(typeof(STextTemplating))asITextTemplating;ITextTemplatingSessionHosthost=t4asITextTemplatingSessionHost;host.Session=host.CreateSession();// Pass a value in Session:host.Session["p1"]=32;// Pass another value in CallContext:System.Runtime.Remoting.Messaging.CallContext.LogicalSetData("p2","test");// Process a small template inline:stringresult=t4.ProcessTemplate("","<#@parameter type=\"System.Int32\" name=\"p1\"#>"+"<#@parameter type=\"System.String\" name=\"p2\"#>"+"Test <#=p1#> <#=p2#>");// Result value is:// Test 32 test

Passing values to a Run-Time (Preprocessed) Text Template

It is not usually necessary to use the <#@parameter#> directive with run-time (preprocessed) text templates. Instead, you can define an additional constructor or a settable property for the generated code, through which you pass parameter values. For more information, see Run-Time Text Generation with T4 Text Templates.

However, if you want to use <#@parameter> in a run-time template, you can pass values to it by using the Session dictionary. As an example, suppose you have created the file as a preprocessed template called PreTextTemplate1. You can invoke the template in your program by using the following code.

PreTextTemplate1t=newPreTextTemplate1();t.Session=newMicrosoft.VisualStudio.TextTemplating.TextTemplatingSession();t.Session["TimesToRepeat"]=5;// Add other parameter values to t.Session here.t.Initialize();// Must call this to transfer values.stringresultText=t.TransformText();

Obtaining arguments from TextTemplate.exe

Important

The parameter directive does not retrieve values set in the -a parameter of the TextTransform.exe utility. To get those values, set hostSpecific="true" in the template directive, and use this.Host.ResolveParameterValue("","","argName").