<Library-Element> (.NET Native)

  • Artikel

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

<Richtlinienelementbibliothekselement><>

Syntax

<Library Name="assembly_name" />

Attribute und Elemente

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

Attribute

attribute 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
<Richtlinien> Das Stammelement einer Laufzeitanweisungsdatei.

Hinweise

Das <Directives-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 beginnt und mit einem Sternchen (*) endet, wirkt sich die <Library> Direktive nur dann aus, 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>

Siehe auch