Elemento <Application> (.NET Native)

Articolo
07/05/2024

Funge da contenitore per i tipi a livello di applicazione e i membri del tipo i cui metadati sono disponibili per la reflection in fase di esecuzione e applica criteri di reflection di runtime a tutti gli elementi del programma in un'applicazione.

<Elemento> Directives <Application> Element (rd.xml)

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre. Nella tabella degli elementi figlio, i criteri fanno riferimento al tipo di metadati che vengono resi disponibili per gli elementi del programma specifico in fase di esecuzione.

Attributi

Attributo	Tipo di attributo	Descrizione
`Activate`	Reflection	Attributo facoltativo. Controlla l'accesso in fase di esecuzione ai costruttori per abilitare l'attivazione di istanze.
`Browse`	Reflection	Attributo facoltativo. Controlla le query per le informazioni o per l'enumerazione dei tipi, ma non abilita l'accesso dinamico al runtime.
`Dynamic`	Reflection	Attributo facoltativo. Controlla l'accesso in fase di esecuzione a tutti i membri dei tipi, inclusi costruttori, metodi, campi, proprietà ed eventi, per abilitare la programmazione dinamica.
`Serialize`	Serializzazione	Attributo facoltativo. Controlla l'accesso in fase di esecuzione a costruttori, campi e proprietà per abilitare la serializzazione e la deserializzazione delle istanze del tipo da parte di librerie quali il serializzatore JSON di Newtonsoft.
`DataContractSerializer`	Serializzazione	Attributo facoltativo. Controlla i criteri per la serializzazione che usano la classe System.Runtime.Serialization.DataContractSerializer.
`DataContractJsonSerializer`	Serializzazione	Attributo facoltativo. Controlla i criteri per la serializzazione JSON che usano la classe System.Runtime.Serialization.Json.DataContractJsonSerializer.
`XmlSerializer`	Serializzazione	Attributo facoltativo. Controlla i criteri per la serializzazione XML che usano la classe System.Xml.Serialization.XmlSerializer.
`MarshalObject`	Interop	Attributo facoltativo. Controlla i criteri per effettuare il marshalling dei tipi di riferimento a Windows Runtime e COM.
`MarshalDelegate`	Interop	Attributo facoltativo. Controlla i criteri per effettuare il marshalling dei tipi delegati come puntatori a funzioni al codice nativo.
`MarshalStructure`	Interop	Attributo facoltativo. Controlla i criteri per effettuare il marshalling delle strutture al codice nativo.

Tutti gli attributi

valore	Descrizione
policy_setting	L'impostazione di questo criterio da applicare ai tipi nell'applicazione. I valori consentiti sono `All`, `Auto`, `Excluded`, `Public`, `PublicAndInternal`, `Required Public`, `Required PublicAndInternal` e `Required All`. Per altre informazioni, vedere Runtime Directive Policy Settings (Impostazioni dei criteri delle direttive di runtime).

Elementi figlio

Elemento	Descrizione
<Assemblaggio>	Applica i criteri a tutti i tipi in un determinato assembly.
<Spazio dei nomi>	Applica i criteri a tutti i tipi in un determinato spazio dei nomi.
<Type>	Applica i criteri a un determinato tipo, ad esempio una classe o una struttura.
<TypeInstantiation>	Applica i criteri a un tipo generico costruito. Ad esempio, un elemento <TypeInstantiation> può essere usato per definire i criteri per un tipo `List<String>` .
<Metodo>	Applica criteri a un metodo su un particolare tipo.
<MethodInstantiation>	Applica i criteri a un metodo generico costruito.
<Proprietà>	Applica criteri a una proprietà su un particolare tipo.
<Campo>	Applica criteri a un campo su un particolare tipo.
<Evento>	Applica criteri a un evento su un particolare tipo.

Elementi padre

Elemento	Descrizione
<Direttive>	L'elemento radice di un file di direttive di runtime.

Osservazioni:

L'elemento <Directives> può contenere nessuno o un elemento <Application>. Non sono supportati più elementi <Application> in un solo file di direttive di reflection.

L'elemento <Application> può essere usato in uno dei due modi seguenti:

Come contenitore per definire gli elementi di programma i cui metadati sono necessari in fase di esecuzione. In tal caso, l'elemento <Application> non deve avere alcun attributo. Durante la compilazione, gli strumenti di compilazione cercano gli elementi di programma identificati dagli elementi figlio dell'elemento <Application> in tutte le librerie, incluse le librerie di base .NET Framework. Al contrario, gli strumenti di compilazione cercano gli elementi di programma identificati dagli elementi figlio di <Library> per gli elementi di programma identificato dagli elementi figlio di <Library>.
Come elemento che imposta i criteri a livello di applicazione per la reflection, la serializzazione e l'interoperabilità. Gli attributi dell'elemento <Application> definiscono i criteri a livello di applicazione, che potrebbero essere sottoposti a override da elementi figlio definiti dall'elemento <Application> o <Library> element.

Condividi tramite