다음을 통해 공유

사용자 지정 T4 텍스트 템플릿 지시문 프로세서 만들기

  • 아티클

‘텍스트 템플릿 변환’ 프로세스에서는 ‘텍스트 템플릿’ 파일을 입력으로 사용하고 텍스트 파일을 출력으로 생성합니다. “텍스트 템플릿 변환 엔진”은 프로세스를 제어하고, 엔진은 텍스트 템플릿 변환 호스트 및 하나 이상의 텍스트 템플릿 “지시문 프로세서”와 상호 작용하여 프로세스를 완료합니다. 자세한 내용은 텍스트 템플릿 변환 프로세스를 참조하세요.

사용자 지정 지시문 프로세서를 만들려면 DirectiveProcessor 또는 RequiresProvidesDirectiveProcessor에서 상속하는 클래스를 만듭니다.

이 두 가지 사이의 차이점은 DirectiveProcessor는 사용자로부터 매개 변수를 가져오고 템플릿 출력 파일을 생성하는 코드를 생성하는 데 필요한 최소 인터페이스를 구현한다는 것입니다. RequiresProvidesDirectiveProcessor는 requires/provides 디자인 패턴을 구현합니다. RequiresProvidesDirectiveProcessor는 두 가지 특수 매개 변수 requires 및 provides를 처리합니다. 예를 들어 사용자 지정 지시문 프로세서는 사용자의 파일 이름을 허용하고, 파일을 열고 읽고, 파일의 텍스트를 fileText라는 변수에 저장할 수 있습니다. RequiresProvidesDirectiveProcessor 클래스의 하위 클래스는 사용자의 파일 이름을 requires 매개 변수의 값으로 사용하고, 텍스트를 provides 매개 변수의 값으로 저장할 변수의 이름을 사용할 수 있습니다. 이 프로세서는 파일을 열고 읽은 다음 지정된 변수에 파일의 텍스트를 저장합니다.

Visual Studio의 텍스트 템플릿에서 사용자 지정 지시문 프로세서를 호출하기 전에 이를 등록해야 합니다.

레지스트리 키를 추가하는 방법에 대한 자세한 내용은 사용자 지정 지시문 프로세서 배포를 참조하세요.

사용자 지정 지시문

사용자 지정 지시문은 다음과 같습니다.

<#@ MyDirective Processor="MyDirectiveProcessor" parameter1="value1" ... #>

텍스트 템플릿에서 외부 데이터 또는 리소스에 액세스하려는 경우 사용자 지정 지시문 프로세서를 사용할 수 있습니다.

다른 텍스트 템플릿이 단일 지시문 프로세서가 제공하는 기능을 공유할 수 있으므로 지시문 프로세서는 코드를 다시 사용할 방법을 제공합니다. 기본 제공 include 지시문은 코드의 일부를 분리하는 데 사용할 수 있으며 다른 텍스트 템플릿 간에 공유할 수 있기 때문에 비슷합니다. 차이점은 include 지시문이 제공하는 모든 기능이 고정되어 있고 매개 변수를 허용하지 않는다는 것입니다. 텍스트 템플릿에 공통 기능을 제공하고 템플릿이 매개 변수를 전달할 수 있도록 하려면 사용자 지정 지시문 프로세서를 만들어야 합니다.

사용자 지정 지시문 프로세서의 몇 가지 예는 다음과 같습니다.

  • 사용자 이름 및 암호를 매개 변수로 허용하는 데이터베이스에서 데이터를 반환하는 지시문 프로세서

  • 파일 이름을 매개 변수로 허용하는 파일을 열고 읽는 지시문 프로세서

사용자 지정 지시문 프로세서의 주요 부분

지시문 프로세서를 만들려면 DirectiveProcessor 또는 RequiresProvidesDirectiveProcessor에서 상속하는 클래스를 만들어야 합니다.

구현해야 하는 가장 중요한 DirectiveProcessor 메서드는 다음과 같습니다.

  • bool IsDirectiveSupported(string directiveName) - 지시문 프로세서가 명명된 지시문을 처리할 수 있으면 true를 반환합니다.

  • void ProcessDirective (string directiveName, IDictionary<string, string> arguments) - 템플릿에서 지시문이 발생할 때마다 템플릿 엔진이 이 메서드를 호출합니다. 프로세서에서 결과를 저장해야 합니다.

모든 ProcessDirective() 호출 후에는 템플릿 엔진이 다음 메서드를 호출합니다.

  • string[] GetReferencesForProcessingRun() - 템플릿 코드에 필요한 어셈블리의 이름을 반환합니다.

  • string[] GetImportsForProcessingRun() - 템플릿 코드에서 사용할 수 있는 네임스페이스를 반환합니다.

  • string GetClassCodeForProcessingRun() - 템플릿 코드에서 사용할 수 있는 메서드, 속성 및 기타 선언의 코드를 반환합니다. 이 작업을 수행하는 가장 쉬운 방법은 C# 또는 Visual Basic 코드를 포함하는 문자열을 작성하는 것입니다. CLR 언어를 사용하는 템플릿에서 지시문 프로세서를 호출할 수 있도록 하려면 문을 CodeDom 트리로 만든 다음 템플릿에 사용된 언어로 트리를 직렬화한 결과를 반환할 수 있습니다.

  • 자세한 내용은 연습: 사용자 지정 지시문 프로세서 만들기를 참조하세요.

관련 콘텐츠