<GenericParameter-Element> (.NET Native)

Artikel
07/05/2024

Wendet die Richtlinie auf den Parametertyp eines generischen Typs oder einer generischen Methode an.

Syntax

<GenericParameter Name="generic_parameter_name"
                  Activate="policy_type"
                  Browse="policy_type"
                  Dynamic="policy_type"
                  Serialize="policy_type"
                  DataContractSerializer="policy_type"
                  DataContractJsonSerializer="policy_type"
                  XmlSerializer="policy_type"
                  MarshalObject="policy_type"
                  MarshalDelegate="policy_type"
                  MarshalStructure="policy_type" />

Attribute und Elemente

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

Attribute

Attribut	Attributtyp	Beschreibung
`Name`	Allgemein	Erforderliches Attribut. Der Name des generischen Parameters. Z. B. muss für den generischen Delegaten Func<T1,T2,TResult> der Wert des `Name`-Attributs "TResult" lauten, um die Laufzeitrichtlinie auf den Rückgabewert des Delegaten anzuwenden.
`Activate`	Reflexion	Optionales Attribut. Steuert den Laufzeitzugriff auf Konstruktoren, um die Aktivierung von Instanzen zu ermöglichen.
`Browse`	Reflexion	Optionales Attribut. Steuert das Abfragen von Informationen über Programmelemente, ermöglicht jedoch keinen Laufzeitzugriff.
`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 Werttypen zu systemeigenem Code.

Namensattribut

Wert	Beschreibung
generic_parameter_name	Erforderliches Attribut. Der Name des generischen Typparameters. Wendet z.B. für den generischen Delegaten Func<T1,T2,TResult> der generic_parameter_name-Wert „TResult“ die Laufzeitrichtlinie auf den Rückgabewert des Delegaten an.

Alle anderen Attribute

Wert	Beschreibung
policy_setting	Die Einstellung, die auf diesen Richtlinientyp angewendet werden soll. Mögliche Werte sind `All`, `Public`, `PublicAndInternal`, `Required Public`, `Required PublicAndInternal` und `Required All`. Weitere Informationen finden Sie unter Richtlinieneinstellungen für die Laufzeitanweisungen.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
<Methode>	Wendet die Laufzeitreflektionsrichtlinie auf einen Konstruktor oder eine Methode an.
<Typ>	Wendet eine Laufzeitreflektionsrichtlinie auf einen bestimmten Typ, z. B. eine Klasse oder Struktur, an.

Hinweise

Das <GenericParameter> Element ist ein untergeordnetes Element des <Method> - oder <Type-Elements> und wird verwendet, um eine Richtlinie auf einen bestimmten generischen Typparameter anzuwenden, der durch seinen Namen in der generischen Typ- oder Methodensignatur angegeben wird.

Das <GenericParameter>-Element ist am nützlichsten, wenn es mit Serialisierungsprogrammen verwendet wird. The following example uses the <GenericParameter> element to apply policy to the type T in calls to the NewtonSoft JSON serializer's JsonConvert.DeserializeObject<T>(String) method overloads.

<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
   <Type Name="Newtonsoft.Json.JsonConvert" >
      <Method Name="DeserializeObject{T}">
         <GenericParameter Name="T" Serialize="Required All" />
      </Method>
   </Type>
</Directives>

Freigeben über