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

Article
07/13/2023

Applique la stratégie de réflexion runtime à tous les types dans un assembly spécifié.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Type d'attribut	Description
`Name`	Généralités	Attribut requis. Spécifie le nom simple d'un assembly.
`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 dans l'assembly 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.

Name (attribut)

Valeur Description

assembly_name Nom simple de l’assembly, sans son extension de fichier. Cet attribut correspond à la propriété AssemblyName.Name. Par exemple, le nom d’un assembly nommé Extensions.dll est « Extensions ».

Vous pouvez également spécifier la chaîne littérale *Application* pour appliquer la stratégie à tous les assemblys dans votre package d'application, que ces assemblys soient chargés ou non. *Application* n'applique jamais la stratégie aux assemblys .NET Framework.

Valeur	Description
assembly_name	Nom simple de l’assembly, sans son extension de fichier. Cet attribut correspond à la propriété AssemblyName.Name. Par exemple, le nom d’un assembly nommé Extensions.dll est « Extensions ». Vous pouvez également spécifier la chaîne littérale `Application` pour appliquer la stratégie à tous les assemblys dans votre package d'application, que ces assemblys soient chargés ou non. `Application` n'applique jamais la stratégie aux assemblys .NET Framework.

Tous les autres attributs

Valeur	Description
policy_setting	Le paramètre s'applique à ce type de stratégie pour tous les types dans l'assembly. 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
<Espace de noms>	Applique la stratégie de réflexion à tous les types dans un espace de noms enfant.
<Type>	Applique la stratégie de réflexion à un type.
<TypeInstantiation>	Applique la stratégie de réflexion à un type générique construit.

Éléments parents

Élément	Description
<Application>	Sert de conteneur pour des types à l'échelle de l'application et pour des membres de types dont les métadonnées sont disponibles pour la réflexion au moment de l'exécution. L’élément <Application> peut avoir zéro, un ou plusieurs `<Assembly>` éléments.
<Bibliothèque>	Définit l'assembly qui contient des types et des membres de types dont les métadonnées sont disponibles pour la réflexion au moment de l'exécution. L’élément <Library> peut avoir zéro ou un `<Assembly>` élément.

Notes

L'élément <Assembly> définit la stratégie runtime pour tous les types dans un assembly. Il diffère de l’élément <Library> , qui spécifie une bibliothèque, mais dépend de ses éléments enfants pour définir la stratégie de réflexion du runtime. L'élément <Assembly> s'applique à tous les types dans un assembly, sauf si elles sont remplacées par un élément enfant.

L’exemple suivant montre comment appliquer la stratégie d’exécution à tous les types d’assemblys au sein de votre package d’application en affectant à l’attribut Name une valeur « *Application* ». L’élément <Assembly> doit être un enfant de l’élément <Application> .

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

Les attributs Activate, Browse, Dynamic et Serialize sont tous facultatifs. Toutefois, l'élément <Assembly> doit contenir au moins un de ces attributs.

Partager via