T4 Assembly 지시문

Visual Studio 디자인 타임 텍스트 템플릿에서는 템플릿 코드에 해당 형식이 사용될 수 있도록 assembly 지시문이 어셈블리를 로드합니다.그 효과는 Visual Studio 프로젝트에 어셈블리 참조를 추가하는 것과 비슷합니다.

텍스트 템플릿 작성에 대한 일반적인 개요를 보려면 T4 텍스트 템플릿 쓰기을 참조하십시오.

[!참고]

전처리된 런타임 텍스트 템플릿에는 assembly 지시문이 필요하지 않습니다.대신 Visual Studio 프로젝트의 참조에 필요한 어셈블리를 추가합니다.

assembly 지시문 사용

지시문의 구문은 다음과 같습니다.

<#@ assembly name="[assembly strong name|assembly file name]" #>

어셈블리 이름은 다음 중 하나여야 합니다.

GAC 어셈블리의 강력한 이름(예: System.Xml.dll).name="System.Xml, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"와 같은 긴 형식도 사용할 수 있습니다.자세한 내용은 AssemblyName을 참조하십시오.
어셈블리의 절대 경로

$(variableName) 구문을 사용하여 Visual Studio 또는 MSBuild 변수(예: $(SolutionDir))를 참조하고 %VariableName%을 사용하여 환경 변수를 참조할 수 있습니다.예를 들면 다음과 같습니다.

<#@ assembly name="$(SolutionDir)\MyProject\bin\Debug\SomeLibrary.Dll" #>

assembly 지시문은 전처리된 텍스트 템플릿에서 아무런 효과가 없습니다.대신 Visual Studio 프로젝트의 References 섹션에 필요한 참조를 포함하십시오.자세한 내용은 T4 텍스트 템플릿을 사용하여 런타임 텍스트 생성을 참조하십시오.

다음 어셈블리가 자동으로 로드되므로 해당 어셈블리에 대한 assembly 지시문을 작성할 필요가 없습니다.

사용자 지정 지시문을 사용하는 경우 지시문 프로세서에서 추가 어셈블리를 로드할 수 있습니다.예를 들어 DSL(도메인별 언어)을 위한 템플릿을 작성하는 경우 다음 어셈블리에 대한 assembly 지시문을 작성할 필요가 없습니다.