Condividi tramite

Impostazioni dei criteri della direttiva di runtime

  • Articolo

Le impostazioni dei criteri della direttiva di runtime per .NET Native determinano la disponibilità di metadati per i tipi e i membri dei tipi al runtime. Senza i metadati necessari, le operazioni che si basano su reflection, serializzazione e deserializzazione o sul marshalling dei tipi .NET Framework a COM o Windows Runtime possono avere esito negativo e generare un'eccezione. Le eccezioni più comuni sono MissingMetadataException e (nel caso dell'interoperabilità) MissingInteropDataException.

Le impostazioni dei criteri di runtime sono controllate da un file di direttive di runtime (.rd.xml). Ogni direttiva di runtime definisce i criteri per un particolare elemento di programma, ad esempio un assembly (l'elemento <Assembly> ), un tipo (l'elemento <Type> ), o un metodo (l'elemento <Method> ). La direttiva include uno o più attributi che definiscono i tipi di criteri di reflection, i tipi di criteri di serializzazione e i tipi di criteri di interoperabilità discussi nella sezione successiva. Il valore dell'attributo definisce l'impostazione dei criteri.

Tipo di criteri

I file di direttive di runtime riconoscono tre categorie di tipi di criteri: reflection, serializzazione e interoperabilità.

  • I tipi di criteri di reflection determinano i metadati disponibili per la reflection al runtime:

    • Activate controlla l'accesso in fase di esecuzione ai costruttori, per abilitare l'attivazione di istanze.

    • Browse controlla le query per le informazioni relative agli elementi di programma.

    • Dynamic controlla l'accesso in fase di esecuzione a tutti i tipi e i membri per abilitare la programmazione dinamica.

    Nella seguente tabella sono elencati i tipi di criteri di reflection e gli elementi di programma con cui possono essere usati.

    Elemento Attiva Esplora Dinamico
    <Applicazione> ✔️ ✔️ ✔️
    <Assemblaggio> ✔️ ✔️ ✔️
    <AttributeImplies> ✔️ ✔️ ✔️
    <Evento> ✔️ ✔️
    <Campo> ✔️ ✔️
    <GenericParameter> ✔️ ✔️ ✔️
    <ImpliesType> ✔️ ✔️ ✔️
    <Metodo> ✔️ ✔️
    <MethodInstantiation> ✔️ ✔️
    <Spazio dei nomi> ✔️ ✔️ ✔️
    <Parametro> ✔️ ✔️ ✔️
    <Proprietà> ✔️ ✔️
    <Sottotipi> ✔️ ✔️ ✔️
    <Type> ✔️ ✔️ ✔️
    <TypeInstantiation> ✔️ ✔️ ✔️
    <TypeParameter> ✔️ ✔️ ✔️

  • I tipi di criteri di serializzazione determinano i metadati disponibili per la serializzazione e la deserializzazione al runtime:

    • Serialize controlla l'accesso in fase di esecuzione ai costruttori, ai campi e alle proprietà per abilitare la serializzazione delle istanze del tipo da parte di librerie di terze parti, ad esempio il serializzatore JSON di Newtonsoft.

    • DataContractSerializer controlla l'accesso in fase di esecuzione ai costruttori, ai campi e alle proprietà per abilitare la serializzazione delle istanze del tipo da parte della classe DataContractSerializer.

    • DataContractJsonSerializer controlla l'accesso in fase di esecuzione ai costruttori, ai campi e alle proprietà per abilitare la serializzazione delle istanze del tipo da parte della classe DataContractJsonSerializer.

    • XmlSerializer controlla l'accesso in fase di esecuzione ai costruttori, ai campi e alle proprietà per abilitare la serializzazione delle istanze del tipo da parte della classe XmlSerializer.

    Nella seguente tabella sono elencati i tipi di criteri di serializzazione e gli elementi di programma con cui possono essere usati.

    Elemento Serialize DataContractSerializer DataContractJsonSerializer XmlSerializer
    <Applicazione> ✔️ ✔️ ✔️ ✔️
    <Assemblaggio> ✔️ ✔️ ✔️ ✔️
    <AttributeImplies> ✔️ ✔️ ✔️ ✔️
    <Evento>
    <Campo> ✔️
    <GenericParameter> ✔️ ✔️ ✔️ ✔️
    <ImpliesType> ✔️ ✔️ ✔️ ✔️
    <Metodo>
    <MethodInstantiation>
    <Spazio dei nomi> ✔️ ✔️ ✔️ ✔️
    <Parametro> ✔️ ✔️ ✔️ ✔️
    <Proprietà> ✔️
    <Sottotipi> ✔️ ✔️ ✔️ ✔️
    <Type> ✔️ ✔️ ✔️ ✔️
    <TypeInstantiation> ✔️ ✔️ ✔️ ✔️
    <TypeParameter> ✔️ ✔️ ✔️ ✔️

  • I tipi di criteri di interoperabilità determinano i metadati disponibili al runtime per passare i tipi di riferimento, i tipi di valore e i puntatori a funzioni a COM e Windows Runtime:

    • MarshalObject controlla il marshalling a COM e Windows Runtime per i tipi di riferimento.

    • MarshalDelegate controlla il marshalling nativo dei tipi delegati come puntatori a funzioni.

    • MarshalStructure controlla il marshalling nativo a COM e Windows Runtime per i tipi di valore.

    Nella seguente tabella sono elencati i tipi di criteri di interoperabilità e gli elementi di programma con cui possono essere usati.

    Elemento MarshalObject MarshalDelegate MarshalStructure
    <Applicazione> ✔️ ✔️ ✔️
    <Assemblaggio> ✔️ ✔️ ✔️
    <AttributeImplies> ✔️ ✔️ ✔️
    <Evento>
    <Campo>
    <GenericParameter> ✔️ ✔️ ✔️
    <ImpliesType> ✔️ ✔️ ✔️
    <Metodo>
    <MethodInstantiation>
    <Spazio dei nomi> ✔️ ✔️ ✔️
    <Parametro> ✔️ ✔️ ✔️
    <Proprietà>
    <Sottotipi> ✔️ ✔️ ✔️
    <Type> ✔️ ✔️ ✔️
    <TypeInstantiation> ✔️ ✔️ ✔️
    <TypeParameter> ✔️ ✔️ ✔️

Impostazioni dei criteri

Ciascun tipo di criteri può essere impostato su uno dei valori elencati nella seguente tabella. Gli elementi che rappresentano i membri dei tipi supportano un set di impostazioni dei criteri diverso rispetto a quello degli altri elementi.

Impostazione criteri Descrizione Elementi Assembly, Namespace, Type e TypeInstantiation Elementi Event, Field, Method, MethodInstantiation e Property
All Abilita i criteri per tutti i tipi e i membri non rimossi dalla catena di strumenti del .NET Native. ✔️
Auto Specifica di usare i criteri predefiniti per il tipo di criteri di un determinato elemento di programma. Questa impostazione equivale all'omissione dei criteri per un determinato tipo di criteri. Auto in genere viene usato per indicare che i criteri sono stati ereditati da un elemento padre. ✔️ ✔️
Excluded Specifica che i criteri sono disabilitati per un determinato elemento di programma. Ad esempio, la direttiva di runtime:

<Type Name="BusinessClasses.Person" Browse="Excluded" Dynamic="Excluded" />

specifica che i metadati per la classe BusinessClasses.Person non sono disponibili né per sfogliare, né per creare dinamicamente un'istanza e modificare gli oggetti Person.		 ✔️ ✔️
Included Abilita i criteri se sono disponibili i metadati per il tipo padre. ✔️
Public Abilita i criteri per i tipi o i membri pubblici, a meno che la catena di strumenti non determini che il tipo o il membro non è necessario e lo rimuova. Questa impostazione è diversa da Required Public, che garantisce la disponibilità costante dei metadati per i tipi e i membri pubblici, anche quando la catena di strumenti li identifica come non necessari. ✔️
PublicAndInternal Abilita i criteri per i tipi o i membri pubblici e interni, a meno che la catena di strumenti non determini che il tipo o il membro non è necessario e lo rimuova. Questa impostazione è diversa da Required PublicAndInternal, che assicura la disponibilità costante dei metadati per i tipi e i membri pubblici e interni, anche quando la catena di strumenti li identifica come non necessari. ✔️
Required Specifica che i criteri per un membro sono abilitati e che i metadati sono disponibili anche se il membro sembra essere in uso. ✔️
Required Public Abilita i criteri per i tipi o i membri pubblici e assicura la disponibilità costante dei metadati per i tipi e i membri pubblici. Questa impostazione è diversa da Public, che rende disponibili i metadati per i tipi e i membri pubblici solo se la catena di strumenti li identifica come necessari. ✔️
Required PublicAndInternal Abilita i criteri per i tipi o i membri pubblici e interni e assicura che i metadati per i tipi e i membri pubblici e interni siano sempre disponibili. Questa impostazione è diversa da PublicAndInternal, che rende disponibili i metadati per i tipi e i membri pubblici e interni solo se la catena di strumenti li identifica come necessari. ✔️
Required All Richiede alla catena di strumenti di mantenere tutti i tipi e i membri indipendentemente dal loro uso effettivo e abilita i relativi criteri. ✔️

Vedi anche