Dela via

IMetaDataDispenserEx::SetOption, metod

  • Artikel

Anger det angivna alternativet till ett angivet värde för det aktuella metadataomfånget. Alternativet styr hur anrop till det aktuella metadataomfånget hanteras.

Syntax

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

Parametrar

optionId
[in] En pekare till ett GUID som anger vilket alternativ som ska anges.

pValue
[in] Det värde som ska användas för att ange alternativet. Typen av det här värdet måste vara en variant av det angivna alternativets typ.

Kommentarer

I följande tabell visas de tillgängliga GUID:erna som parametern optionId kan peka på och motsvarande giltiga värden för parametern pValue .

GUID Description pValue Parametern
MetaDataCheckDuplicatesFor Kontrollerar vilka objekt som söks efter dubbletter. Varje gång du anropar en IMetaDataEmit-metod som skapar ett nytt objekt kan du be metoden att kontrollera om objektet redan finns i det aktuella omfånget. Du kan till exempel kontrollera om det finns mdMethodDef objekt. I det här fallet, när du anropar IMetaDataEmit::D efineMethod, kontrollerar den att metoden inte redan finns i det aktuella omfånget. Den här kontrollen använder nyckeln som unikt identifierar en viss metod: överordnad typ, namn och signatur. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för CorCheckDuplicatesFor-uppräkningen .
MetaDataRefToDefCheck Kontroller som refererar till objekt konverteras till definitioner. Som standard optimerar metadatamotorn koden genom att konvertera ett refererat objekt till dess definition om det refererade objektet faktiskt definieras i det aktuella omfånget. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för CorRefToDefCheck-uppräkningen .
MetaDataNotificationForTokenMovement Styr vilka tokenommappningar som inträffar under en metadatasammanslagning som genererar återanrop. Använd metoden IMetaDataEmit::SetHandler för att upprätta IMapToken-gränssnittet . Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för uppräkningen CorNotificationForTokenMovement .
MetaDataSetENC Styr beteendet för edit-and-continue (ENC). Endast ett beteendeläge kan anges i taget. Måste vara en variant av typen UI4 och måste innehålla ett värde för CorSetENC-uppräkningen . Värdet är inte en bitmask.
MetaDataErrorIfEmitOutOfOrder Kontroller som genereras i fel som inte är i ordning genererar återanrop. Det är inte allvarligt att generera metadata i fel ordning. Men om du genererar metadata i en ordning som prioriteras av metadatamotorn är metadata mer kompakta och kan därför sökas mer effektivt. IMetaDataEmit::SetHandler Använd metoden för att upprätta IMetaDataError-gränssnittet. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för uppräkningen CorErrorIfEmitOutOfOrder .
MetaDataImportOption Styr vilka typer av objekt som togs bort under en ENC som hämtas av en uppräknare. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för uppräkningsuppräkningen CorImportOptions .
MetaDataThreadSafetyOptions Styr om metadatamotorn hämtar läsar-/skrivarlås, vilket säkerställer trådsäkerheten. Som standard förutsätter motorn att åtkomsten är enkeltrådad av anroparen, så inga lås hämtas. Klienter ansvarar för att upprätthålla korrekt trådsynkronisering när metadata-API:et används. Måste vara en variant av typen UI4 och måste innehålla ett värde för uppräkningen CorThreadSafetyOptions . Värdet är inte en bitmask.
MetaDataGenerateTCEAdapters Styr om typbiblioteksimportören ska generera nära kopplade händelsekort (TCE) för COM-anslutningspunktcontainrar. Måste vara en variant av typen BOOL. Om pValue är inställt på truegenererar typbiblioteksimportören TCE-korten.
MetaDataTypeLibImportNamespace Anger ett namnområde som inte är standard för typbiblioteket som importeras. Måste vara antingen ett null-värde eller en variant av typen BSTR. Om pValue är ett null-värde anges det aktuella namnområdet till null. Annars är det aktuella namnområdet inställt på strängen som lagras i variantens BSTR-typ.
MetaDataLinkerOptions Styr om länkaren ska generera en sammansättning eller en .NET Framework modulfil. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för CorLinkerOptions-uppräkningen .
MetaDataRuntimeVersion Anger vilken version av common language runtime som avbildningen skapades mot. Versionen lagras som en sträng, till exempel "v1.0.3705". Måste vara ett null-värde, ett VT_EMPTY-värde eller en variant av typen BSTR. Om pValue är null är körningsversionen inställd på null. Om pValue är VT_EMPTY anges versionen till ett standardvärde som hämtas från versionen av Mscorwks.dll där metadatakoden körs. Annars är körningsversionen inställd på strängen som lagras i variantens BSTR-typ.
MetaDataMergerOptions Anger alternativ för sammanslagning av metadata. Måste vara en variant av typen UI4 och måste innehålla en kombination av värdena för MergeFlags uppräkningen, som beskrivs i filen CorHdr.h.
MetaDataPreserveLocalRefs Inaktiverar optimering av lokala referenser till definitioner. Måste innehålla en kombination av värdena för uppräkningen CorLocalRefPreservation .

Krav

Plattform: Se Systemkrav.

Huvudet: Cor.h

Bibliotek: Används som en resurs i MsCorEE.dll

.NET Framework versioner: Tillgänglig sedan 1.0

Se även