<qualifyAssembly> 요소
부분 이름이 사용될 때 동적으로 로드되어야 하는 어셈블리의 전체 이름을 지정합니다.
<configuration>
<runtime>
<assemblyBinding>
<qualifyAssembly>
구문
<qualifyAssembly partialName=
"PartialAssemblyName"
fullName="FullAssemblyName"/>
특성 및 요소
다음 섹션에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.
특성
특성 | 설명 |
---|---|
partialName |
필수 특성입니다. 코드에 나타나는 어셈블리의 부분 이름을 지정합니다. |
fullName |
필수 특성입니다. 전역 어셈블리 캐시에 나타나는 어셈블리의 전체 이름을 지정합니다. |
자식 요소
없음
부모 요소
요소 | Description |
---|---|
assemblyBinding |
어셈블리 버전 리디렉션 및 어셈블리 위치에 대한 정보를 포함합니다. |
configuration |
공용 언어 런타임 및 .NET Framework 애플리케이션에서 사용하는 모든 구성 파일의 루트 요소입니다. |
runtime |
어셈블리 바인딩 및 가비지 컬렉션에 대한 정보를 포함합니다. |
설명
부분 어셈블리 이름을 사용하여 Assembly.Load 메서드를 호출하면 공용 언어 런타임이 애플리케이션 기본 디렉터리에서만 어셈블리를 찾습니다. 애플리케이션 구성 파일에서 <qualifyAssembly> 요소를 사용하여 전체 어셈블리 정보(이름, 버전, 공개 키 토큰 및 문화권)를 제공하며 공용 언어 런타임이 전역 어셈블리 캐시에서 어셈블리를 찾도록 합니다.
fullName 특성에는 이름, 버전, 공개 키 토큰 및 문화권의 네 개의 어셈블리 ID 필드가 포함되어야 합니다. partialName 특성은 어셈블리를 부분적으로 참조해야 합니다. 적어도 어셈블리의 텍스트 이름(가장 일반적인 경우)을 지정해야 하지만 버전, 공개 키 토큰 또는 문화권(또는 네 가지 모두가 아니라, 네 가지의 모든 조합)을 포함할 수도 있습니다. partialName은 호출에 지정된 이름과 일치해야 합니다. 예를 들어, 구성 파일에서 partialName 특성으로 "math"
를 지정하고 코드에서 Assembly.Load("math, Version=3.3.3.3")
를 호출할 수 없습니다.
예제
다음 예제에서는 논리적으로 Assembly.Load("math")
호출을 Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral")
로 변환합니다.
<configuration>
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<qualifyAssembly partialName="math"
fullName=
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>
</assemblyBinding>
</runtime>
</configuration>
참고 항목
.NET