T4 매개 변수 지시문

아티클
01/13/2024

Visual Studio에서 parameter 지시문이 외부 컨텍스트로부터 전달된 값에서 초기화되는 속성을 템플릿 코드에 선언합니다. 텍스트 변환을 호출하는 코드를 작성하는 경우 이러한 값을 설정할 수 있습니다.

Parameter 지시문 사용

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

parameter 지시문은 외부 컨텍스트로부터 전달된 값에서 초기화되는 속성을 템플릿 코드에 선언합니다. 텍스트 변환을 호출하는 코드를 작성하는 경우 이러한 값을 설정할 수 있습니다. Session 사전 또는 CallContext에서 값을 전달할 수 있습니다.

원격 형식의 매개 변수를 선언할 수 있습니다. 즉, 매개 변수 형식은 SerializableAttribute를 사용하여 선언되거나 MarshalByRefObject에서 파생되어야 합니다. 이렇게 하면 템플릿이 처리되는 AppDomain에 매개 변수 값을 전달할 수 있습니다.

예를 들어 다음 내용이 있는 텍스트 템플릿을 작성할 수 있습니다.

<#@ template language="C#" #>

<#@ parameter type="System.Int32" name="TimesToRepeat" #>

<# for (int i = 0; i < TimesToRepeat; i++) { #>
Line <#= i #>
<# } #>

템플릿에 매개 변수 값 전달

메뉴 명령 또는 이벤트 처리기와 같은 Visual Studio 확장을 작성하는 경우 텍스트 템플릿 서비스를 사용하여 템플릿을 처리할 수 있습니다.

// Get a service provider - how you do this depends on the context:
IServiceProvider serviceProvider = dte; // or dslDiagram.Store, for example
// Get the text template service:
ITextTemplating t4 = serviceProvider.GetService(typeof(STextTemplating)) as ITextTemplating;
ITextTemplatingSessionHost host = t4 as ITextTemplatingSessionHost;
// 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:
string result = t4.ProcessTemplate("MyTemplateFile.t4",
  System.IO.File.ReadAllText("MyTemplateFile.t4"));

호출 컨텍스트에서 값 전달

또는 CallContext에서 값을 논리 데이터로 전달할 수 있습니다.

다음 예제에서는 두 방법을 모두 사용하여 값을 전달합니다.

ITextTemplating t4 = this.Store.GetService(typeof(STextTemplating)) as ITextTemplating;
ITextTemplatingSessionHost host = t4 as ITextTemplatingSessionHost;
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:
string result = t4.ProcessTemplate("",
   "<#@parameter type=\"System.Int32\" name=\"p1\"#>"
 + "<#@parameter type=\"System.String\" name=\"p2\"#>"
 + "Test <#=p1#> <#=p2#>");

// Result value is:
//     Test 32 test

런타임(전처리) 텍스트 템플릿에 값 전달

일반적으로 런타임(전처리) 텍스트 템플릿과 함께 <#@parameter#> 지시문을 사용할 필요는 없습니다. 대신 생성된 코드에 대해 추가 생성자 또는 설정 가능한 속성을 정의할 수 있으며, 이를 통해 매개 변수 값을 전달합니다. 자세한 내용은 T4 텍스트 템플릿을 사용하여 런타임 텍스트 생성을 참조하세요.

그러나 런타임 템플릿에서 <#@parameter>를 사용하려는 경우 세션 사전을 사용하여 값을 전달할 수 있습니다. 예를 들어 PreTextTemplate1이라는 전처리된 템플릿으로 파일을 만들었다고 가정합니다. 다음 코드를 사용하여 프로그램에서 템플릿을 호출할 수 있습니다.

PreTextTemplate1 t = new PreTextTemplate1();
t.Session = new Microsoft.VisualStudio.TextTemplating.TextTemplatingSession();
t.Session["TimesToRepeat"] = 5;
// Add other parameter values to t.Session here.
t.Initialize(); // Must call this to transfer values.
string resultText = t.TransformText();

TextTemplate.exe에서 인수 얻기

Important

parameter 지시문은 TextTransform.exe 유틸리티의 -a 매개 변수에 설정된 값을 검색하지 않습니다. 이러한 값을 얻으려면 template 지시문에서 hostSpecific="true"를 설정하고 this.Host.ResolveParameterValue("","","argName")를 사용합니다.

다음을 통해 공유