Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.