Udostępnij przez

IMetaDataDispenserEx::SetOption Method

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.

Syntax

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

Parameters

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

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

Remarks

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

GUID Description 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. Możesz na przykład sprawdzić istnienie mdMethodDef elementów. W tym przypadku wywołanie metody IMetaDataEmit::D efineMethod sprawdzi, czy metoda nie istnieje jeszcze w bieżącym zakresie. Ta kontrola 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 element, do których odwołuje się odwołanie, do jego definicji, 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 tokenów 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 kontynuacji (ENC). Jednocześnie można ustawić tylko jeden tryb zachowania. Musi być wariantem typu UI4 i musi zawierać wartość wyliczenia CorSetENC . Wartość nie jest maską bitów.
MetaDataErrorIfEmitOutOfOrder Określa, które błędy emitowane 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/modułu 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 nie są uzyskiwane żadne blokady. Klienci są odpowiedzialni za utrzymywanie 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ą bitów.
MetaDataGenerateTCEAdapters Określa, czy importer biblioteki typów powinien generować ściśle powiązane karty zdarzeń (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. 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 wartość ma wartość null, wersja środowiska uruchomieniowego jest ustawiona na 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 opisanego w pliku CorHdr.h.
MetaDataPreserveLocalRefs Wyłącza optymalizowanie odwołań lokalnych do definicji. Musi zawierać kombinację wartości wyliczenia CorLocalRefPreservation .

Requirements

Podest: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Header: Cor.h

Library: CorGuids.lib

See also

  • Last updated on