다음을 통해 공유

코드 생성 및 T4 텍스트 템플릿

  • 아티클

Visual Studio에서 ‘T4 텍스트 템플릿’은 텍스트 파일을 생성할 수 있는 제어 논리 및 텍스트 블록이 혼합된 것입니다. 제어 논리는 Visual C# 또는 Visual Basic에서 프로그램 코드 조각으로 작성되었습니다. T4 템플릿 지시문에서 C# 버전 6.0 기능을 사용할 수 있습니다. 생성된 파일은 웹 페이지, 리소스 파일 또는 임의 언어로 작성된 프로그램 소스 코드와 같은 텍스트일 수 있습니다.

특정 문제 공간에서 문을 표현하도록 설계된 DSL(도메인 특정 언어)의 경우 도메인 특정 언어에서 코드를 생성하는 방법을 알아봅니다.

T4 텍스트 템플릿에는 런타임 시간과 디자인 타임, 두 가지 종류가 있습니다.

런타임 T4 텍스트 템플릿

런타임 템플릿을 '전처리된' 템플릿이라고도 합니다. 애플리케이션에서 템플릿을 실행하여 출력의 일부로 텍스트 문자열을 생성합니다. 예를 들어 HTML 페이지를 정의하는 템플릿을 만들 수 있습니다.

<html><body>
 The date and time now is: <#= DateTime.Now #>
</body></html>

템플릿은 생성된 출력과 유사합니다. 결과 출력과 템플릿이 유사하기 때문에 템플릿을 변경하려는 경우 실수를 방지할 수 있습니다.

또한 템플릿에는 프로그램 코드 조각이 포함됩니다. 이러한 조각을 사용하여 텍스트 섹션을 반복하고, 조건부 섹션을 만들고, 애플리케이션의 데이터를 표시할 수 있습니다.

출력을 생성하기 위해 애플리케이션은 템플릿에 의해 생성된 함수를 호출합니다. 예시:

string webResponseText = new MyTemplate().TransformText();

Visual Studio가 설치되지 않은 컴퓨터에서 애플리케이션을 실행할 수 있습니다.

런타임 템플릿을 만들려면 전처리된 텍스트 템플릿 파일을 프로젝트에 추가합니다. 또한 일반 텍스트 파일을 추가하고 해당 사용자 지정 도구 속성을 TextTemplatingFilePreprocessor로 설정할 수 있습니다.

자세한 내용은 T4 텍스트 템플릿을 사용하여 런타임 텍스트 생성을 참조하세요. 템플릿 구문에 대한 자세한 내용은 T4 텍스트 템플릿 쓰기를 참조하세요.

디자인 타임 T4 텍스트 템플릿

디자인 타임 템플릿은 소스 코드의 일부와 애플리케이션의 다른 리소스를 정의합니다. 일반적으로 단일 입력 파일이나 데이터베이스의 데이터를 읽고 .cs, .vb 또는 다른 소스 파일의 일부를 생성하는 여러 템플릿을 사용합니다. 각 템플릿은 하나의 파일을 생성하고 Visual Studio 또는 MSBuild 내에서 빌드됩니다.

예를 들어 입력 데이터는 구성 데이터의 XML 파일일 수 있습니다. 개발 중에 XML 파일을 편집할 때마다 텍스트 템플릿에서 애플리케이션 코드의 일부가 다시 생성됩니다. 템플릿 중 하나는 다음 예제와 유사할 수 있습니다.

<#@ output extension=".cs" #>
<#@ assembly name="System.Xml" #>
<#
 System.Xml.XmlDocument configurationData = ...; // Read a data file here.
#>
namespace Fabrikam.<#= configurationData.SelectSingleNode("jobName").Value #>
{
  ... // More code here.
}

생성된 .cs 파일은 XML 파일 값을 기반으로 하는 다음의 형식입니다.

namespace Fabrikam.FirstJob
{
  ... // More code here.
}

또 다른 예로 비즈니스 활동의 워크플로 다이어그램을 입력으로 사용할 수 있습니다. 사용자가 비즈니스 워크플로를 변경하거나 다른 워크플로를 가진 새 사용자로 작업을 시작할 때 새 모델에 맞게 코드를 쉽게 다시 생성할 수 있습니다.

참고 항목

모델 이란 용어는 때때로 하나 이상의 템플릿에서 읽은 데이터를 설명하는 데 사용됩니다. 모델은 모든 형식과 종류의 파일 또는 데이터베이스일 수 있으며 UML 모델이나 도메인 특정 언어 모델이 아니어도 됩니다. '모델'은 단지 데이터가 코드와 달리 비즈니스 개념 측면에서 정의될 수 있음을 나타냅니다. 디자인 타임 템플릿은 요구 사항이 변경됨에 따라 구성을 변경할 때 더 빠르고 안정적입니다. 일반적으로 입력은 워크플로 예제와 같이 비즈니스 요구 사항 측면에서 정의됩니다. 디자인 타임 템플릿은 민첩한 개발 프로세스에 유용한 도구입니다.

디자인 타임 템플릿을 만들려면 텍스트 템플릿 파일을 프로젝트에 추가합니다. 또는 일반 텍스트 파일을 추가하고 해당 사용자 지정 도구 속성을 TextTemplatingFileGenerator로 설정할 수 있습니다.

자세한 내용은 T4 텍스트 템플릿을 사용하여 디자인 타임 코드 생성을 참조하세요. 템플릿 구문에 대한 자세한 내용은 T4 텍스트 템플릿 쓰기를 참조하세요.

텍스트 템플릿 변환 기능을 T4라고 합니다.

참고 항목