다음을 통해 공유


T4 텍스트 변환 사용자 지정

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

이 부분에서는

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

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

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

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

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