<Library-Element (.NET Native)>

Artikel
07/05/2024

Definiert die Assembly, die Typen und Typmember enthält, deren Metadaten zur Laufzeit für die Reflektion verfügbar sind.

<Direktiven-Elementbibliothekselement> <>

Syntax

<Library Name="assembly_name" />

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
`Name`	Erforderliches Attribut. Gibt den Namen einer Assembly an. Untergeordnete Elemente dieses `<Library>`-Elements definieren die Laufzeitreflektionsrichtlinie für Typen und Typmember in dieser Assembly.

Namensattribut

Wert	Beschreibung
assembly_name	Der einfache Name der Assembly ohne Dateierweiterung. Dieses Attribut entspricht der AssemblyName.Name-Eigenschaft. Der Name einer Assembly namens Extensions.dll lautet beispielsweise "Extensions". Im Abschnitt „Hinweise“ ist eine besondere Form von assembly_name beschrieben, die den bedingten Einschluss von Metadaten aus der Assembly unterstützt.

Untergeordnete Elemente

Element	BESCHREIBUNG
<Assembly>	Wendet die Richtlinie auf alle Typen in einer bestimmten Assembly an.
<Namespace>	Wendet die Richtlinie auf alle Typen in einem bestimmten Namespace an.
<Typ>	Wendet die Richtlinie auf einen bestimmten Typ, z. B. eine Klasse oder Struktur, an.
<TypeInstantiation>	Wendet die Richtlinie auf einen konstruierten generischen Typ an. Beispielsweise könnte ein <TypeInstantiation-Element> verwendet werden, um eine Richtlinie für einen `List<String>` Typ zu definieren.

Übergeordnete Elemente

Element	Beschreibung
<Anweisungen>	Das Stammelement einer Laufzeitanweisungsdatei.

Hinweise

Das <Direktiven-Element> kann null, ein oder mehrere <Library> Elemente enthalten.

Das <Library>-Element dient als Container für die Definition der Programmelemente, deren Metadaten zur Laufzeit benötigt werden. Dieses Element drückt keine Richtlinie aus. Zur Kompilierzeit durchsuchen die Compilertools nur die im <Library>-Element bezeichnete Bibliothek nach Programmelementen, die durch seine untergeordneten Elemente identifiziert werden. Im Gegensatz dazu durchsuchen Compilertools alle Bibliotheken, including.NET Framework-Kernbibliotheken, nach Programmelementen, die durch untergeordnete Elemente des <Application-Elements> identifiziert werden.

<Library>-Direktiven können bedingt verwendet werden. Wenn der Name des <Library> Elements mit einem Sternchen (*) beginnt und endet, hat die <Library> Direktive nur dann Auswirkungen, wenn die zwischen den Sternchen angegebene Assembly von der App referenziert wird. Die folgende Laufzeitdirektive gilt beispielsweise nur, wenn von der App auf die Utilities.dll-Assembly verwiesen wird.

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

Freigeben über