<Assembly-Element (.NET Native)>

Artikel
07/05/2024

Wendet die Laufzeitreflektionsrichtlinie auf alle Typen in einer angegebenen Assembly an.

Syntax

<Assembly Name="assembly_name"
          Activate="policy_setting"
          Browse="policy_setting"
          Dynamic="policy_setting"
          Serialize="policy_setting"
          DataContractSerializer="policy_setting"
          DataContractJsonSerializer="policy_setting"
          XmlSerializer="policy_setting"
          MarshalObject="policy_setting"
          MarshalDelegate="policy_setting"
          MarshalStructure="policy_setting" />

Attribute und Elemente

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

Attribute

Attribut	Attributtyp	Beschreibung
`Name`	Allgemein	Erforderliches Attribut. Gibt den einfachen Namen einer Assembly an.
`Activate`	Reflexion	Optionales Attribut. Steuert den Laufzeitzugriff auf Konstruktoren, um die Aktivierung von Instanzen zu ermöglichen.
`Browse`	Reflexion	Optionales Attribut. Steuert das Abfragen nach Informationen über die Typen oder das Auflisten der Typen in der Assembly, aber ermöglicht keinen dynamischen Zugriff zur Laufzeit.
`Dynamic`	Reflexion	Optionales Attribut. Steuert den Laufzeitzugriff auf alle Typmember, einschließlich Konstruktoren, Methoden, Felder, Eigenschaften und Ereignisse, um die dynamische Programmierung zu ermöglichen.
`Serialize`	Serialisierung	Optionales Attribut. Steuert den Laufzeitzugriff auf Konstruktoren, Felder und Eigenschaften, um Serialisierung und Deserialisierung von Typinstanzen durch Bibliotheken wie das Newtonsoft JSON-Serialisierungsprogramm zu ermöglichen.
`DataContractSerializer`	Serialisierung	Optionales Attribut. Steuert die Richtlinie für die Serialisierung, die die System.Runtime.Serialization.DataContractSerializer-Klasse verwendet.
`DataContractJsonSerializer`	Serialisierung	Optionales Attribut. Steuert die Richtlinie für die JSON-Serialisierung, die die System.Runtime.Serialization.Json.DataContractJsonSerializer-Klasse verwendet.
`XmlSerializer`	Serialisierung	Optionales Attribut. Steuert die Richtlinie für die XML-Serialisierung, die die System.Xml.Serialization.XmlSerializer-Klasse verwendet.
`MarshalObject`	Interop	Optionales Attribut. Steuert die Richtlinie für das Marshalling von Verweistypen zu Windows-Runtime und COM.
`MarshalDelegate`	Interop	Optionales Attribut. Steuert die Richtlinie für das Marshalling von Delegattypen als Funktionszeiger zu systemeigenem Code.
`MarshalStructure`	Interop	Optionales Attribut. Steuert die Richtlinie für das Marshalling von Strukturen zu nativem Code.

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".

Sie können auch die Literalzeichenfolge *Application* angeben, um die Richtlinie auf alle Assemblys im App-Paket anzuwenden, egal, ob diese Assemblys geladen sind oder nicht. *Application* wendet die Richtlinie nie auf .NET Framework-Assemblys an.

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". Sie können auch die Literalzeichenfolge `Application` angeben, um die Richtlinie auf alle Assemblys im App-Paket anzuwenden, egal, ob diese Assemblys geladen sind oder nicht. `Application` wendet die Richtlinie nie auf .NET Framework-Assemblys an.

Alle anderen Attribute

Wert	Beschreibung
policy_setting	Die Einstellung, die auf diesen Richtlinientyp für alle Typen in der Assembly anzuwenden ist. Mögliche Werte sind `All`, `Auto`, `Excluded`, `Public`, `PublicAndInternal`, `Required Public`, `Required PublicAndInternal` und `Required All`. Weitere Informationen finden Sie unter Richtlinieneinstellungen für die Laufzeitanweisungen.

Untergeordnete Elemente

Element	BESCHREIBUNG
<Namespace>	Wendet die Reflektionsrichtlinie auf alle Typen in einem untergeordneten Namespace an.
<Typ>	Wendet die Reflektionsrichtlinie auf einen Typ an.
<TypeInstantiation>	Wendet die Reflektionsrichtlinie auf einen konstruierten generischen Typ an.

Übergeordnete Elemente

Element	Beschreibung
<Anwendung>	Dient als Container für anwendungsweite Typen und Typmember, deren Metadaten zur Laufzeit für die Reflektion verfügbar sind. Das <Application-Element> kann null, ein oder mehrere `<Assembly>` Elemente aufweisen.
<Bibliothek>	Definiert die Assembly, die Typen und Typmember enthält, deren Metadaten zur Laufzeit für die Reflektion verfügbar sind. Das <Library-Element> kann null oder ein `<Assembly>` Element aufweisen.

Hinweise

Das <Assembly>-Element definiert eine Laufzeitrichtlinie für alle Typen in einer Assembly. Sie unterscheidet sich vom <Library-Element> , das eine Bibliothek angibt, hängt jedoch von den untergeordneten Elementen ab, um die Laufzeitreflektionsrichtlinie zu definieren. Das <Assembly>-Element gilt für alle Typen in einer Assembly, sofern sie nicht von einem untergeordneten Element überschrieben werden.

Das folgende Beispiel zeigt, wie Sie laufzeitrichtlinie auf alle Typen in Assemblys innerhalb Des App-Pakets anwenden können, indem Sie dem Name Attribut den Wert "*Application*" zuweisen. Das <Assembly> Element muss ein untergeordnetes Element des <Application-Elements> sein.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
  <Application>
     <Assembly Name="*Application*" Dynamic="Required All" />
  </Application>
</Directives>

Die Attribute Activate, Browse, Dynamic und Serialize sind optional. Allerdings muss das <Assembly>-Element mindestens eines dieser Attribute enthalten.

Freigeben über