Condividi tramite

IMetaDataDispenserEx::SetOption Method

Imposta l'opzione specificata su un valore specificato per l'ambito dei metadati corrente. L'opzione controlla come vengono gestite le chiamate all'ambito dei metadati corrente.

Syntax

HRESULT SetOption (
    [in] REFGUID optionId,
    [in] const VARIANT *pValue
);

Parameters

optionId [in] Puntatore a un GUID che specifica l'opzione da impostare.

pValue [in] Valore da utilizzare per impostare l'opzione . Il tipo di questo valore deve essere una variante del tipo dell'opzione specificata.

Remarks

Nella tabella seguente sono elencati i GUID disponibili a cui il optionId parametro può puntare e i valori validi corrispondenti per il pValue parametro .

GUID Description pValue Parametro
MetaDataCheckDuplicatesFor Controlla quali elementi vengono controllati per i duplicati. Ogni volta che si chiama un metodo IMetaDataEmit che crea un nuovo elemento, è possibile chiedere al metodo di verificare se l'elemento esiste già nell'ambito corrente. Ad esempio, è possibile verificare l'esistenza di mdMethodDef elementi. In questo caso, quando si chiama IMetaDataEmit::D efineMethod, si verificherà che il metodo non esista già nell'ambito corrente. Questo controllo usa la chiave che identifica in modo univoco un determinato metodo: tipo padre, nome e firma. Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorCheckDuplicatesFor .
MetaDataRefToDefCheck Controlli a cui si fa riferimento gli elementi vengono convertiti in definizioni. Per impostazione predefinita, il motore di metadati ottimizza il codice convertendo un elemento a cui viene fatto riferimento nella relativa definizione se l'elemento a cui si fa riferimento è effettivamente definito nell'ambito corrente. Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorRefToDefCheck .
MetaDataNotificationForTokenMovement Controlla il mapping dei token che si verificano durante un'unione di metadati genera callback. Usare il metodo IMetaDataEmit::SetHandler per stabilire l'interfaccia IMapToken . Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorNotificationForTokenMovement .
MetaDataSetENC Controlla il comportamento di modifica e continuazione (ENC). È possibile impostare una sola modalità di comportamento alla volta. Deve essere una variante di tipo UI4 e deve contenere un valore dell'enumerazione CorSetENC . Il valore non è una maschera di bit.
MetaDataErrorIfEmitOutOfOrder I controlli che generano errori non ordinati generano callback. L'emissione di metadati non in ordine non è irreversibile; Tuttavia, se si generano metadati in un ordine preferito dal motore di metadati, i metadati sono più compatti e pertanto possono essere ricercati in modo più efficiente. Usare il metodo per stabilire l'interfaccia IMetaDataEmit::SetHandlerIMetaDataError . Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorErrorIfEmitOutOfOrder .
MetaDataImportOption Controlla quali tipi di elementi eliminati durante un ENC vengono recuperati da un enumeratore. Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorImportOptions .
MetaDataThreadSafetyOptions Controlla se il motore di metadati ottiene blocchi lettore/writer, garantendo così la thread safety. Per impostazione predefinita, il motore presuppone che l'accesso sia a thread singolo dal chiamante, quindi non vengono ottenuti blocchi. I client sono responsabili della gestione corretta della sincronizzazione dei thread quando si usa l'API dei metadati. Deve essere una variante di tipo UI4 e deve contenere un valore dell'enumerazione CorThreadSafetyOptions . Il valore non è una maschera di bit.
MetaDataGenerateTCEAdapters Controlla se l'utilità di importazione della libreria dei tipi deve generare gli adattatori TCE (TightLy Coupled Event) per i contenitori dei punti di connessione COM. Deve essere una variante di tipo BOOL. Se pValue è impostato su true, l'utilità di importazione della libreria dei tipi genera gli adattatori TCE.
MetaDataTypeLibImportNamespace Specifica uno spazio dei nomi non predefinito per la libreria dei tipi da importare. Deve essere un valore Null o una variante di tipo BSTR. Se pValue è un valore Null, lo spazio dei nomi corrente è impostato su Null; in caso contrario, lo spazio dei nomi corrente viene impostato sulla stringa contenuta nel tipo BSTR della variante.
MetaDataLinkerOptions Controlla se il linker deve generare un assembly o un file di modulo .NET. Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione CorLinkerOptions .
MetaDataRuntimeVersion Specifica la versione di Common Language Runtime in base alla quale è stata compilata l'immagine. La versione viene archiviata come stringa, ad esempio "v1.0.3705". Deve essere un valore Null, un valore VT_EMPTY o una variante di tipo BSTR. Se pValue è Null, la versione di runtime è impostata su Null. Se pValue è VT_EMPTY, la versione viene impostata su un valore predefinito, che viene disegnato dalla versione di Mscorwks.dll in cui è in esecuzione il codice dei metadati. In caso contrario, la versione di runtime viene impostata sulla stringa contenuta nel tipo BSTR della variante.
MetaDataMergerOptions Specifica le opzioni per l'unione dei metadati. Deve essere una variante di tipo UI4 e deve contenere una combinazione dei valori dell'enumerazione MergeFlags , descritta nel file CorHdr.h.
MetaDataPreserveLocalRefs Disabilita l'ottimizzazione dei riferimenti locali nelle definizioni. Deve contenere una combinazione dei valori dell'enumerazione CorLocalRefPreservation .

Requirements

Piattaforma: Vedere Sistemi operativi supportati da .NET.

Header: Cor.h

Library: CorGuids.lib

See also

  • Last updated on