Compartir a través de

<Elemento Library (.NET Native)>

  • Artículo

Define el ensamblado que contiene los tipos y miembros de tipo cuyos metadatos están disponibles para la reflexión en tiempo de ejecución.

<Elemento <Library> de directivas>

Sintaxis

<Library Name="assembly_name" />

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
Name Atributo necesario. Especifica el nombre de un ensamblado. Los elementos secundarios de este elemento <Library> definen la directiva de reflexión en tiempo de ejecución para los tipos y miembros de tipos en este ensamblado.

Name (atributo)

Valor Descripción
assembly_name Nombre simple del ensamblado sin la extensión de archivo. Este atributo corresponde a la propiedad AssemblyName.Name. Por ejemplo, el nombre de un ensamblado denominado Extensions.dll es "Extensions". Vea la sección Comentarios para conocer una forma especial de assembly_name que admite la inclusión condicional de metadatos del ensamblado.

Elementos secundarios

Elemento Descripción
<Ensamblaje> Aplica la directiva a todos los tipos en un ensamblado determinado.
<Espacio de nombres> Aplica la directiva a todos los tipos en un espacio de nombres determinado.
<Tipo> Aplica la directiva a un tipo determinado, como una clase o una estructura.
<TypeInstantiation> Aplica la directiva a un tipo genérico construido. Por ejemplo, se podría usar un <elemento TypeInstantiation> para definir la directiva de un List<String> tipo.

Elementos primarios

Elemento Descripción
<Directivas> Elemento raíz de un archivo de directivas en tiempo de ejecución.

Comentarios

El <elemento Directive> puede contener cero, uno o más <Library> elementos.

El elemento <Library> sirve de contenedor para definir los elementos de programa cuyos metadatos son necesarios en tiempo de ejecución. Este elemento no expresa la directiva. En tiempo de compilación, las herramientas del compilador buscan únicamente en la biblioteca designada por el elemento <Library> para encontrar los elementos de programa identificados por sus elementos secundarios. En cambio, las herramientas del compilador buscan en todas las bibliotecas, including.NET bibliotecas principales de Framework, para los elementos de programa identificados por elementos secundarios del elemento Application>.<

Las directivas de <Library> se pueden usar de manera condicional. Si el nombre del <Library> elemento comienza y termina con un asterisco (*), la <Library> directiva solo tiene efecto si la aplicación hace referencia al ensamblado especificado entre los asteriscos. Por ejemplo, la siguiente directiva en tiempo de ejecución solo se aplica si la aplicación hace referencia al ensamblado Utilities.dll.

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

Consulte también