다음을 통해 공유


<qualifyAssembly> 요소

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

<구성>
   <런타임>
     <assemblyBinding>
       <qualifyAssembly>

문법

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

특성 및 요소

다음의 섹션은 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

Attributes

특성 Description
partialName 필수 특성입니다.

코드에 표시되는 어셈블리의 부분 이름을 지정합니다.
fullName 필수 특성입니다.

전역 어셈블리 캐시에 표시되는 어셈블리의 전체 이름을 지정합니다.

자식 요소

없음.

부모 요소

요소 Description
assemblyBinding 어셈블리 버전 리디렉션 및 어셈블리의 위치에 대한 정보를 포함합니다.
configuration 공용 언어 런타임 및 .NET Framework 애플리케이션에서 사용하는 모든 구성 파일의 루트 요소입니다.
runtime 어셈블리 바인딩 및 가비지 수집에 대한 정보를 포함합니다.

비고

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

특성에는 fullName 이름, 버전, 공개 키 토큰 및 문화권의 네 가지 어셈블리 ID 필드가 포함되어야 합니다. 특성은 partialName 어셈블리를 부분적으로 참조해야 합니다. 어셈블리의 텍스트 이름(가장 일반적인 경우)을 지정해야 하지만 버전, 공개 키 토큰 또는 문화권(또는 4개 모두의 조합이 아님)을 포함할 수도 있습니다. 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>

참고하십시오