다음을 통해 공유


T4 텍스트 변환 사용자 지정

텍스트 템플릿은 변환 프로세스를 통해 프로그램 코드나 다른 텍스트 파일을 생성할 수 있도록 하는 Visual Studio의 기능입니다. Visual Studio SDK를 사용하면 텍스트 템플릿 지시문 프로세서 또는 텍스트 템플릿 호스트를 사용자 지정하여 기본 템플릿 변환 프로세스를 확장할 수 있습니다.

이 섹션의 내용

텍스트 템플릿 변환 프로세스: 텍스트 변환의 작동 방식과 템플릿 호스트 및 지시문 프로세서의 역할에 대해 설명합니다.

사용자 지정 T4 텍스트 템플릿 지시문 프로세서 만들기: 지시문 프로세서는 <#@template#>. 같은 템플릿의 지시문을 처리하며, 템플릿을 컴파일하는 동안 실행되고 어셈블리 및 기타 리소스를 로드할 수 있습니다. 또한 런타임에 리소스를 로드할 코드를 삽입할 수 있습니다. 고유한 지시문 프로세서를 정의하면 템플릿의 복잡성을 줄일 수 있습니다.

VS 확장에서 텍스트 변환 호출: 메뉴 명령이나 이벤트 처리기와 같은 Visual Studio 확장을 작성하는 경우, 확장은 텍스트 템플릿 서비스를 사용하여 텍스트 템플릿을 변환할 수 있습니다. Session 개체를 사용하여 매개 변수 데이터를 템플릿에 전달하고 <#@parameter#> 지시문을 사용하여 템플릿 내에서 값을 가져올 수 있습니다.

사용자 지정 호스트를 사용하여 텍스트 템플릿 처리: 텍스트 템플릿의 코드가 실행되면 호스트는 외부 파일 및 애플리케이션 상태에 대한 액세스를 제공합니다. 예를 들어 Visual Studio에서 텍스트 변환을 실행하는 호스트는 솔루션 탐색기에 대한 액세스를 제공할 수 있습니다. 오류 메시지 창에 오류도 표시합니다. 다른 컨텍스트에서 텍스트 변환을 실행하려는 경우 해당 컨텍스트에서 사용할 수 있는 서비스에 대한 액세스를 제공하는 고유한 호스트를 정의할 수 있습니다.

Visual Studio 확장을 작성하는 경우 고유한 호스트를 작성하는 대신 기존 텍스트 변환 서비스를 사용하는 것이 좋습니다. 자세한 내용은 VS 확장에서 텍스트 변환 호출을 참조하세요.