Udostępnij za pośrednictwem

IMetaDataDispenserEx::SetOption — Metoda

  • Artykuł

Ustawia określoną opcję na daną wartość dla bieżącego zakresu metadanych. Opcja określa sposób obsługi wywołań do bieżącego zakresu metadanych.

Składnia

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

Parametry

optionId
[w] Wskaźnik do identyfikatora GUID, który określa opcję do ustawienia.

pValue
[w] Wartość, która ma zostać użyta do ustawienia opcji. Typ tej wartości musi być wariantem typu określonej opcji.

Uwagi

W poniższej tabeli wymieniono dostępne identyfikatory GUID, do których optionId parametr może wskazywać i odpowiednie prawidłowe wartości parametru pValue .

GUID Opis pValue Parametr
MetaDataCheckDuplicatesFor Określa, które elementy są sprawdzane pod kątem duplikatów. Za każdym razem, gdy wywołujesz metodę IMetaDataEmit , która tworzy nowy element, możesz poprosić metodę o sprawdzenie, czy element już istnieje w bieżącym zakresie. Na przykład możesz sprawdzić istnienie mdMethodDef elementów. W tym przypadku wywołasz metodę IMetaDataEmit::D efineMethod, sprawdzi, czy metoda nie istnieje jeszcze w bieżącym zakresie. To sprawdzenie używa klucza, który jednoznacznie identyfikuje daną metodę: typ nadrzędny, nazwę i podpis. Musi być wariantem typu UI4 i musi zawierać kombinację wartości corcheckDuplicatesFor enumeration.
MetaDataRefToDefCheck Kontrolki, do których odwołuje się elementy, są konwertowane na definicje. Domyślnie aparat metadanych zoptymalizuje kod, konwertując przywoływalny element na jego definicję, jeśli element, do których odwołuje się odwołanie, jest rzeczywiście zdefiniowany w bieżącym zakresie. Musi być wariantem typu UI4 i musi zawierać kombinację wartości wyliczenia CorRefToDefCheck .
MetaDataNotificationForTokenMovement Określa, które ponowne mapy tokenu występują podczas scalania metadanych, generują wywołania zwrotne. Użyj metody IMetaDataEmit::SetHandler , aby ustanowić interfejs IMapToken . Musi być wariantem typu UI4 i musi zawierać kombinację wartości wyliczenia CorNotificationForTokenMovement .
MetaDataSetENC Steruje zachowaniem funkcji edycji i kontynuowania (ENC). W danym momencie można ustawić tylko jeden tryb zachowania. Musi być wariantem typu UI4 i musi zawierać wartość wyliczenia CorSetENC . Wartość nie jest maską bitową.
MetaDataErrorIfEmitOutOfOrder Kontroluje, które emitowane błędy poza kolejnością generują wywołania zwrotne. Emitowanie metadanych poza kolejnością nie jest krytyczne; jeśli jednak emitujesz metadane w kolejności preferowanej przez aparat metadanych, metadane są bardziej kompaktowe i dlatego można je wydajniej wyszukiwać. IMetaDataEmit::SetHandler Użyj metody , aby ustanowić interfejs IMetaDataError. Musi być wariantem typu UI4 i musi zawierać kombinację wartości wyliczenia CorErrorIfEmitOutOfOrder .
MetaDataImportOption Steruje rodzajami elementów, które zostały usunięte podczas ENC, są pobierane przez moduł wyliczający. Musi być wariantem typu UI4 i musi zawierać kombinację wartości wyliczenia CorImportOptions .
MetaDataThreadSafetyOptions Określa, czy aparat metadanych uzyskuje blokady czytnika/zapisywania, zapewniając bezpieczeństwo wątków. Domyślnie aparat zakłada, że dostęp jest jednowątkowy przez obiekt wywołujący, więc żadne blokady nie są uzyskiwane. Klienci są odpowiedzialni za utrzymanie właściwej synchronizacji wątków podczas korzystania z interfejsu API metadanych. Musi być wariantem typu UI4 i musi zawierać wartość wyliczenia CorThreadSafetyOptions . Wartość nie jest maską bitową.
MetaDataGenerateTCEAdapters Określa, czy importer biblioteki typów powinien generować karty zdarzeń ściśle powiązanych (TCE) dla kontenerów punktów połączenia COM. Musi być wariantem typu BOOL. Jeśli pValue ustawiono wartość true, importer biblioteki typów generuje karty TCE.
MetaDataTypeLibImportNamespace Określa inną niż domyślną przestrzeń nazw dla importowanej biblioteki typów. Musi być wartością null lub wariantem typu BSTR. Jeśli pValue jest wartością null, bieżąca przestrzeń nazw jest ustawiona na wartość null. W przeciwnym razie bieżąca przestrzeń nazw jest ustawiona na ciąg przechowywany w typie BSTR wariantu.
MetaDataLinkerOptions Określa, czy konsolidator powinien wygenerować zestaw, czy plik modułu .NET Framework. Musi być wariantem typu UI4 i musi zawierać kombinację wartości wyliczenia CorLinkerOptions .
MetaDataRuntimeVersion Określa wersję środowiska uruchomieniowego języka wspólnego, względem którego utworzono ten obraz. Wersja jest przechowywana jako ciąg, taki jak "v1.0.3705". Musi być wartością null, wartością VT_EMPTY lub wariantem typu BSTR. Jeśli pValue ma wartość null, wersja środowiska uruchomieniowego ma wartość null. Jeśli pValue jest VT_EMPTY, wersja jest ustawiona na wartość domyślną, która jest pobierana z wersji Mscorwks.dll, w której jest uruchomiony kod metadanych. W przeciwnym razie wersja środowiska uruchomieniowego jest ustawiona na ciąg przechowywany w typie BSTR wariantu.
MetaDataMergerOptions Określa opcje scalania metadanych. Musi być wariantem typu UI4 i musi zawierać kombinację wartości MergeFlags wyliczenia, która jest opisana w pliku CorHdr.h.
MetaDataPreserveLocalRefs Wyłącza optymalizowanie odwołań lokalnych do definicji. Musi zawierać kombinację wartości wyliczenia CorLocalRefPreservation .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: Cor.h

Biblioteki: Używane jako zasób w MsCorEE.dll

wersje .NET Framework: dostępne od wersji 1.0

Zobacz też