<Library, élément (.NET Native)>
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.
<Directives>, élément de bibliothèque d’éléments <>
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. |
| <Espace de 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. |
Notes
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 toutes les bibliothèques, including.NET bibliothèques principales framework, pour 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 a un effet uniquement 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>