<Library>, élément (.NET Native)

Article
07/13/2023

Définit l'assembly qui contient des types et des membres de types dont les métadonnées sont disponibles pour la réflexion au moment de l'exécution.

<Élément de bibliothèque> d’éléments <Directives>

Syntaxe

<Library Name="assembly_name" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`Name`	Attribut requis. Spécifie le nom d'un assembly. Les éléments enfants de cet élément `<Library>` définissent la stratégie de réflexion runtime pour les types et membres de type se trouvant dans cet assembly.

Name (attribut)

Valeur	Description
assembly_name	Nom simple de l’assembly, sans son extension de fichier. Cet attribut correspond à la propriété AssemblyName.Name. Par exemple, le nom d’un assembly nommé Extensions.dll est « Extensions ». Consultez la section Notes pour connaître une forme particulière de nom_assembly qui prend en charge l’inclusion conditionnelle de métadonnées à partir de l’assembly.

Éléments enfants

Élément	Description
<Assembly>	Applique la stratégie à tous les types d'un assembly particulier.
<Noms>	Applique la stratégie à tous les types d'un espace de noms particulier.
<Type>	Applique la stratégie à un type particulier, tel qu'une classe ou une structure.
<TypeInstantiation>	Applique la stratégie à un type générique construit. Par exemple, un <élément TypeInstantiation> peut être utilisé pour définir une stratégie pour un `List<String>` type.

Éléments parents

Élément	Description
<Directives>	Élément racine d'un fichier de directives de runtime.

Remarques

L’élément <Directives> peut contenir zéro, un ou plusieurs <Library> éléments.

L'élément <Library> sert de conteneur pour la définition des éléments de programme dont les métadonnées sont nécessaires au moment de l'exécution ; cet élément n'exprime pas la stratégie. Au moment de la compilation, les outils du compilateur recherchent uniquement dans la bibliothèque désignée par l'élément <Library> les éléments de programme identifiés par ses éléments enfants. En revanche, les outils du compilateur recherchent dans toutes les bibliothèques, including.NET bibliothèques principales du framework, les éléments de programme identifiés par les éléments enfants de l’élément< Application>.

Les directives <Library> peuvent être utilisées de manière conditionnelle. Si le nom de l’élément <Library> commence et se termine par un astérisque (*), la <Library> directive n’a d’effet que si l’assembly spécifié entre les astérisques est référencé par l’application. Par exemple, la directive runtime suivante s’applique uniquement si l’assembly Utilities.dll est référencé par l’application.

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

Share via