<Application, élément (.NET Native)>

Article
07/13/2023

Sert de conteneur pour les types à l'échelle de l'application et pour les membres de type dont les métadonnées sont disponibles pour la réflexion au moment de l'exécution, et applique la stratégie de réflexion runtime à tous les éléments de programme dans une application.

<Directives> , élément <Application> (rd.xml)

Syntaxe

<Application 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" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents. Dans le tableau Éléments enfants, la stratégie fait référence au type de métadonnées rendues disponibles pour des éléments de programme spécifiques au moment de l'exécution.

Attributs

Attribut	Type d'attribut	Description
`Activate`	Réflexion	Attribut facultatif. Contrôle l'accès aux constructeurs pour permettre l'activation d'instances au moment de l'exécution.
`Browse`	Réflexion	Attribut facultatif. Contrôle la demande d'informations sur les types ou l'énumération de ceux-ci, mais ne permet pas d'effectuer un accès dynamique au moment de l'exécution.
`Dynamic`	Réflexion	Attribut facultatif. Contrôle l'accès à l'exécution à tous les membres de types, y compris les constructeurs, les méthodes, les champs, les propriétés et les événements, pour permettre la programmation dynamique.
`Serialize`	Sérialisation	Attribut facultatif. Contrôle l'accès au moment de l'exécution aux constructeurs, champs et propriétés, pour permettre la sérialisation et la désérialisation des instances de types par des bibliothèques comme le sérialiseur JSON Newtonsoft.
`DataContractSerializer`	Sérialisation	Attribut facultatif. Contrôle la stratégie pour la sérialisation qui utilise la classe System.Runtime.Serialization.DataContractSerializer.
`DataContractJsonSerializer`	Sérialisation	Attribut facultatif. Contrôle la stratégie pour la sérialisation JSON qui utilise la classe System.Runtime.Serialization.Json.DataContractJsonSerializer.
`XmlSerializer`	Sérialisation	Attribut facultatif. Contrôle la stratégie pour la sérialisation XML qui utilise la classe System.Xml.Serialization.XmlSerializer.
`MarshalObject`	Interop	Attribut facultatif. Contrôle la stratégie pour le marshaling des types de références vers Windows Runtime et COM.
`MarshalDelegate`	Interop	Attribut facultatif. Contrôle la stratégie pour le marshaling des types de délégués comme pointeurs de fonction vers du code natif.
`MarshalStructure`	Interop	Attribut facultatif. Stratégie de contrôles pour le marshaling de structures en code natif.

Tous les attributs

Valeur	Description
policy_setting	Paramètre de cette stratégie à appliquer aux types dans l'application. Les valeurs possibles sont `All`, `Auto`, `Excluded`, `Public`, `PublicAndInternal`, `Required Public`, `Required PublicAndInternal` et `Required All`. Pour plus d’informations, consultez Paramètres de stratégie de directive runtime.

É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.
<Méthode>	Applique la stratégie à une méthode sur un type particulier.
<MethodInstantiation>	Applique la stratégie à une méthode générique construite.
<Propriété>	Applique la stratégie à une propriété sur un type particulier.
<Champ>	Applique la stratégie à un champ sur un type particulier.
<Event>	Applique la stratégie à un événement sur un type particulier.

É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 ou un <Application> élément. Un même fichier de directives de réflexion ne peut pas contenir plusieurs éléments <Application>.

Un élément <Application> peut être utilisé de deux manières différentes :

En tant que conteneur pour définir des éléments de programme dont les métadonnées sont nécessaires au moment de l'exécution. Dans ce cas, l'élément <Application> n'a pas besoin d'attributs. Au moment de la compilation, les outils du compilateur recherchent dans toutes les bibliothèques, y compris les bibliothèques principales du .NET Framework, les éléments de programme identifiés par les éléments enfants de l'élément <Application>. En revanche, les outils du compilateur recherchent uniquement la bibliothèque désignée par l’élément <Library> pour les éléments de programme identifiés par les éléments enfants de <la bibliothèque.>
En tant qu'élément qui définit la stratégie à l'échelle de l'application pour la réflexion, la sérialisation et l'interopérabilité. Les attributs de l’élément définissent une stratégie à l’échelle de l’application <Application> , qui peut être remplacée par les éléments enfants définis par l’élément <Application> ou <Library> .

Partager via