<qualifyAssembly> 요소

부분 이름이 사용될 때 동적으로 로드되어야 하는 어셈블리의 전체 이름을 지정합니다.

<qualifyAssembly partialName="PartialAssemblyName"
                 fullName="FullAssemblyName"/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

자식 요소

없음

부모 요소

설명

부분 어셈블리 이름을 사용하여 Assembly.Load 메서드를 호출하면 공용 언어 런타임은 응용 프로그램 기본 디렉터리에서만 어셈블리를 찾습니다. 응용 프로그램 구성 파일에서 <qualifyAssembly> 요소를 사용하여 전체 어셈블리 정보(이름, 버전, 공개 키 토큰 및 문화권)를 제공하며 공용 언어 런타임이 전역 어셈블리 캐시에서 어셈블리를 찾도록 합니다.

fullName 특성에는 어셈블리 ID의 네 가지 필드(이름, 버전, 공개 키 토큰 및 문화권)가 포함되어야 합니다. partialName 특성은 어셈블리를 부분적으로 참조해야 합니다. 최소한 어셈블리의 텍스트 이름은 지정해야 하며(가장 일반적인 경우), 버전, 공개 키 토큰 또는 문화권도 포함시킬 수 있습니다. 이 네 필드의 가능한 조합도 지정할 수 있지만 네 필드 모두를 지정해서는 안 됩니다. partialName은 호출에서 지정한 이름과 일치해야 합니다. 예를 들어, 구성 파일에서 "math"를 partialName 특성으로 지정하고 코드에서 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>

참고 항목

참조

런타임 설정 스키마

개념

런타임에서 어셈블리를 찾는 방법

부분 어셈블리 참조