ITextTemplatingEngineHost 인터페이스

업데이트: 2010년 6월

텍스트 템플릿을 변환하는 호스트의 인터페이스입니다. 이것은 지시문 프로세서에서 사용할 수 있으며 텍스트 템플릿에서도 액세스할 수 있습니다.

네임스페이스:  Microsoft.VisualStudio.TextTemplating
어셈블리:  Microsoft.VisualStudio.TextTemplating.Interfaces.10.0(Microsoft.VisualStudio.TextTemplating.Interfaces.10.0.dll)

구문

‘선언
<CLSCompliantAttribute(True)> _
Public Interface ITextTemplatingEngineHost

[CLSCompliantAttribute(true)]
public interface ITextTemplatingEngineHost

[CLSCompliantAttribute(true)]
public interface class ITextTemplatingEngineHost

[<CLSCompliantAttribute(true)>]
type ITextTemplatingEngineHost =  interface end

public interface ITextTemplatingEngineHost

ITextTemplatingEngineHost 형식에서는 다음과 같은 멤버를 노출합니다.

속성

	이름	설명
	StandardAssemblyReferences	어셈블리 참조의 목록을 가져옵니다.
	StandardImports	네임스페이스의 목록을 가져옵니다.
	TemplateFile	처리될 텍스트 템플릿의 경로와 파일 이름을 가져옵니다.

위쪽

메서드

	이름	설명
	GetHostOption	지정된 옵션 값을 요청하기 위해 엔진에 의해 호출됩니다.알 수 없는 경우 Null을 반환합니다.
	LoadIncludeText	부분 텍스트 템플릿 파일을 포함하는 요청에 해당하는 텍스트를 가져옵니다.
	LogErrors	변환 엔진에서 오류와 경고의 컬렉션을 받습니다.
	ProvideTemplatingAppDomain	생성된 변환 클래스를 실행할 응용 프로그램 도메인을 제공합니다.
	ResolveAssemblyReference	호스트에서 어셈블리의 위치에 대한 추가 정보를 제공할 수 있도록 합니다.
	ResolveDirectiveProcessor	이름이 제공된 지시문 프로세서의 형식을 반환합니다.
	ResolveParameterValue	매개 변수가 템플릿 텍스트에 지정되지 않은 경우 지시문 프로세서에 대한 매개 변수 값을 확인합니다.
	ResolvePath	호스트에서 파일 이름 또는 상대 경로가 지정된 전체 경로를 제공할 수 있습니다.
	SetFileExtension	생성된 텍스트 출력에 예상되는 파일 확장명을 호스트에 알려 줍니다.
	SetOutputEncoding	생성된 텍스트 출력에 예상되는 인코딩을 호스트에 알려 줍니다.

위쪽

설명

호스트에서는 텍스트 템플릿 파일을 입력으로 사용하고 텍스트 파일을 출력으로 생산합니다. 일반적인 호스트는 Visual Studio 프로젝트에서 템플릿을 변환하는 TextTemplatingFileGenerator 도구입니다. 다른 종류의 템플릿으로 처리하기 위한 하나 이상의 지시문 프로세서를 호출합니다. 이 인터페이스의 멤버는 지시문 프로세서 및 텍스트 템플릿의 코드에 액세스할 수 있습니다. 텍스트 템플릿 엔진은 이 프로세스를 제어하고 호스트와 하나 이상의 지시문 처리기와 상호 작용합니다. 이러한 구성 요소에 대한 자세한 내용을 보려면 코드 생성 및 T4 텍스트 템플릿을 참조하십시오.

텍스트 템플릿 코드에 호스트를 액세스할 수 있도록 설정하려면 템플릿 지시문의 hostspecific 매개 변수를 설정합니다. 예를 들면 다음과 같습니다.

<#@template language="c#" hostspecific="true" #>
<# // This template is specific to the TextTemplatingFileGenerator host,
   // which transforms templates in a Visual Studio project. #>
These are the projects in this solution:
<#=this.Host.ResolveParameterValue("-", "-", "projects") #>

Visual Studio 또는 사용자 지정 도구 외에 텍스트 템플릿을 사용하려는 경우 이 인터페이스를 구현하여 사용자 지정 호스트를 작성할 수 있습니다. 예제를 보려면 연습: 사용자 지정 텍스트 템플릿 호스트 만들기을 참조하십시오.

팁

Visual Studio에서 실행될 패키지나 확장을 작성하는 경우 고유 호스트를 작성하는 대신 텍스트 템플릿 서비스를 사용하십시오. 자세한 내용은 VS 확장에서 텍스트 변환 호출을 참조하십시오.

참고 항목

참조

Microsoft.VisualStudio.TextTemplating 네임스페이스

기타 리소스

연습: 사용자 지정 텍스트 템플릿 호스트 만들기

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

변경 기록

날짜	변경 내용	이유
2010년 6월	일부 메서드 설명에 대해 명확히 설명했습니다.	향상된 기능 관련 정보