다음을 통해 공유

<라이브러리> 요소(.NET 네이티브)

  • 아티클

런타임에 해당 메타데이터를 리플렉션에 사용할 수 있는 형식 및 형식 멤버가 포함된 어셈블리를 정의합니다.

<지시문> 요소 <라이브러리> 요소

구문

<Library Name="assembly_name" />

특성 및 요소

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

특성

특성 설명
Name 필수 특성입니다. 어셈블리의 이름을 지정합니다. 이 <Library> 요소의 자식 요소는 이 어셈블리에 있는 형식 및 형식 멤버에 대한 런타임 리플렉션 정책을 정의합니다.

이름 특성

값 설명
assembly_name 파일 확장명이 없는 어셈블리의 단순한 이름입니다. 이 특성은 AssemblyName.Name 속성에 해당합니다. 예를 들어 Extensions.dll 어셈블리의 이름은 "Extensions"입니다. 어셈블리에서 조건부 메타데이터 포함을 지원하는 특수 assembly_name 형식에 대한 내용은 설명 섹션을 참조하세요.

자식 요소

요소 설명
<어셈블리> 특정 어셈블리의 모든 형식에 정책을 적용합니다.
<네임스페이스> 특정 네임스페이스의 모든 형식에 정책을 적용합니다.
<형식> 클래스 또는 구조체와 같은 특정 형식에 정책을 적용합니다.
<TypeInstantiation> 생성된 제네릭 형식에 정책을 적용합니다. 예를 들어 <TypeInstantiation> 요소를 사용하면 List<String> 형식에 대한 정책을 정의할 수 있습니다.

부모 요소

요소 설명
<지시문> 런타임 지시문 파일의 루트 요소입니다.

설명

<Directives> 요소는 <Library> 요소를 포함하지 않을 수도 있고 하나 이상 포함할 수도 있습니다.

<Library> 요소는 런타임에 해당 메타데이터가 필요한 프로그램 요소를 정의하는 컨테이너로 사용되며 정책을 표현하지는 않습니다. 컴파일 타임에 컴파일러 도구는 <Library> 요소로 지정된 라이브러리에서만 자식 요소가 식별한 프로그램 요소를 검색합니다. 반면 컴파일러 도구는 .NET Framework 핵심 라이브러리를 비롯한 모든 라이브러리에서 <Application> 요소의 자식 요소가 식별한 프로그램 요소를 검색합니다.

<Library> 지시문은 조건부로 사용할 수 있습니다. <Library> 요소의 이름이 별표(*)로 시작하고 끝나는 경우 앱이 별표 사이에 지정된 어셈블리를 참조할 때만 <Library> 지시문이 적용됩니다. 예를 들어 다음 런타임 지시문은 앱에서 Utilities.dll 어셈블리를 참조하는 경우에만 적용됩니다.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Library Name="*Utilities*">
   ...
  </Library>
</Directives>

참고 항목