Elemento <Application> (.NET Native)<Application> Element (.NET Native)

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.Serves as a container for application-wide types and type members whose metadata is available for reflection at run time, and applies runtime reflection policy to all the program elements in an app.

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

SintassiSyntax

<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 elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements. 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.In the Child Elements table, policy refers to the kind of metadata that is made available for particular program elements at run time.

AttributiAttributes

AttributoAttribute Tipo di attributoAttribute type DescrizioneDescription
Activate ReflectionReflection Attributo facoltativo.Optional attribute. Controlla l'accesso in fase di esecuzione ai costruttori per abilitare l'attivazione di istanze.Controls runtime access to constructors to enable activation of instances.
Browse ReflectionReflection Attributo facoltativo.Optional attribute. Controlla le query per le informazioni o per l'enumerazione dei tipi, ma non abilita l'accesso dinamico al runtime.Controls querying for information about or enumerating the types, but does not enable any dynamic access at run time.
Dynamic ReflectionReflection Attributo facoltativo.Optional attribute. 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.Controls runtime access to all type members, including constructors, methods, fields, properties, and events, to enable dynamic programming.
Serialize SerializzazioneSerialization Attributo facoltativo.Optional attribute. 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.Controls runtime access to constructors, fields, and properties, to enable type instances to be serialized and deserialized by libraries such as the Newtonsoft JSON serializer.
DataContractSerializer SerializzazioneSerialization Attributo facoltativo.Optional Attribute. Controlla i criteri per la serializzazione che usano la classe System.Runtime.Serialization.DataContractSerializer.Controls policy for serialization that uses the System.Runtime.Serialization.DataContractSerializer class.
DataContractJsonSerializer SerializzazioneSerialization Attributo facoltativo.Optional Attribute. Controlla i criteri per la serializzazione JSON che usano la classe System.Runtime.Serialization.Json.DataContractJsonSerializer.Controls policy for JSON serialization that uses the System.Runtime.Serialization.Json.DataContractJsonSerializer class.
XmlSerializer SerializzazioneSerialization Attributo facoltativo.Optional Attribute. Controlla i criteri per la serializzazione XML che usano la classe System.Xml.Serialization.XmlSerializer.Controls policy for XML serialization that uses the System.Xml.Serialization.XmlSerializer class.
MarshalObject InteroperabilitàInterop Attributo facoltativo.Optional Attribute. Controlla i criteri per effettuare il marshalling dei tipi di riferimento a Windows Runtime e COM.Controls policy for marshaling reference types to Windows Runtime and COM.
MarshalDelegate InteroperabilitàInterop Attributo facoltativo.Optional Attribute. Controlla i criteri per effettuare il marshalling dei tipi delegati come puntatori a funzioni al codice nativo.Controls policy for marshaling delegate types as function pointers to native code.
MarshalStructure InteroperabilitàInterop Attributo facoltativo.Optional Attribute. Controlla i criteri per il marshalling delle strutture al codice nativo.Controls policy for marshaling structures to native code.

Tutti gli attributiAll attributes

ValoreValue DescrizioneDescription
policy_settingpolicy_setting L'impostazione di questo criterio da applicare ai tipi nell'applicazione.The setting for this policy to apply to the types in the app. I valori consentiti sono All, Auto, Excluded, Public, PublicAndInternal, Required Public, Required PublicAndInternal e Required All.Possible values are All, Auto, Excluded, Public, PublicAndInternal, Required Public, Required PublicAndInternal, and Required All. Per altre informazioni, vedere Runtime Directive Policy Settings (Impostazioni dei criteri delle direttive di runtime).For more information, see Runtime Directive Policy Settings.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<Assembly><Assembly> Applica i criteri a tutti i tipi in un determinato assembly.Applies policy to all the types in a particular assembly.
<Namespace><Namespace> Applica i criteri a tutti i tipi in un determinato spazio dei nomi.Applies policy to all the types in a particular namespace.
<Type><Type> Applica i criteri a un determinato tipo, ad esempio una classe o una struttura.Applies policy to a particular type, such as a class or structure.
<TypeInstantiation><TypeInstantiation> Applica i criteri a un tipo generico costruito.Applies policy to a constructed generic type. Ad esempio, un elemento <TypeInstantiation> può essere usato per definire i criteri per un tipo List<String>.For example, a <TypeInstantiation> element could be used to define policy for a List<String> type.
<Method><Method> Applica criteri a un metodo su un particolare tipo.Applies policy to a method on a particular type.
<MethodInstantiation><MethodInstantiation> Applica i criteri a un metodo generico costruito.Applies policy to a constructed generic method.
<Property><Property> Applica criteri a una proprietà su un particolare tipo.Applies policy to a property on a particular type.
<Field><Field> Applica criteri a un campo su un particolare tipo.Applies policy to a field on a particular type.
<Event><Event> Applica criteri a un evento su un particolare tipo.Applies policy to an event on a particular type.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
<Directives><Directives> L'elemento radice di un file di direttive di runtime.The root element of a runtime directives file.

NoteRemarks

L'elemento <Directives> può contenere nessuno o un elemento <Application>.The <Directives> element can contain zero or one <Application> element. Non sono supportati più elementi <Application> in un solo file di direttive di reflection.Multiple <Application> elements in a single reflection directives file are not supported.

L'elemento <Application> può essere usato in uno dei due modi seguenti:The <Application> element can be used in one of two ways:

  • Come contenitore per definire gli elementi di programma i cui metadati sono necessari in fase di esecuzione.As a container to define the program elements whose metadata is needed at run time. In tal caso, l'elemento <Application> non deve avere alcun attributo.In this case, the <Application> element need not have any attributes. 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.At compile time, compiler tools search all libraries, including .NET Framework core libraries, for program elements identified by child elements of the <Application> element. Al contrario, gli strumenti di compilazione cercano gli elementi di programma identificati dagli elementi figlio di <Library> solo nella libreria designata dall'elemento <Library>.In contrast, compiler tools search only the library designated by the <Library> element for program elements identified by the child elements of <Library>.

  • Come elemento che imposta i criteri a livello di applicazione per la reflection, la serializzazione e l'interoperabilità.As an element that sets application-wide policy for reflection, serialization, and interop. Gli attributi dell'elemento <Application> definiscono i criteri a livello di applicazione, che possono essere sottoposti a override da elementi figlio definiti dall'elemento <Application> o <Library>.The attributes of the <Application> element define application-wide policy, which may be overridden by the child elements defined by the <Application> or <Library> element.

Vedere ancheSee Also

<Libreria > elemento<Library> Element
<Direttive > elemento<Directives> Element
Elementi direttiva di runtimeRuntime Directive Elements
Informazioni di riferimento sul file di configurazione delle direttive di runtime (rd.xml)Runtime Directives (rd.xml) Configuration File Reference