<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>  

참고 항목