IMetaDataDispenserEx::SetOption-Methode

Artikel
08/10/2011

Legt die angegebene Option auf einen bestimmten Wert für den aktuellen Metadatenbereich fest. Die Option steuert, wie Aufrufe des aktuellen Metadatenbereichs behandelt werden.

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

Parameter

optionId
[in] Ein Zeiger auf eine GUID, die die festzulegende Option angibt.
pValue
[in] Der Wert, der zum Festlegen der Option verwendet wird. Der Typ dieses Werts muss eine Variante des angegebenen Typs der Option sein.

Hinweise

Die folgende Tabelle listet die verfügbaren GUIDs auf, auf die der optionId-Parameter zeigen kann, sowie die entsprechenden gültigen Werte für den pValue-Parameter.

GUID	Beschreibungen	pValue-Parameter
MetaDataCheckDuplicatesFor	Steuerelemente, deren Elemente auf Duplikate überprüft werden. Jedes Mal, wenn Sie eine IMetaDataEmit-Methode aufrufen, die ein neues Element erstellt, können Sie mithilfe der Methode überprüfen, ob das Element bereits im aktuellen Bereich vorhanden ist. Sie können z. B. das Vorhandensein von mdMethodDef-Elementen prüfen. Wenn Sie in diesem Fall IMetaDataEmit::DefineMethod aufrufen, überprüft diese, ob die Methode bereits im aktuellen Bereich vorhanden ist. Diese Überprüfung verwendet den Schlüssel, der eine angegebene Methode eindeutig identifiziert: übergeordneter Typ, Name und Signatur.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorCheckDuplicatesFor-Enumeration enthalten.
MetaDataRefToDefCheck	Steuert, welche Elemente, auf die verwiesen werden, in Definitionen konvertiert werden. Standardmäßig optimiert das Metadatenmodul den Code, indem ein Element, auf das verwiesen wird, gemäß seiner Definition konvertiert wird, wenn das Element, auf das verwiesen wird, tatsächlich im aktuellen Bereich definiert ist.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorRefToDefCheck-Enumeration enthalten.
MetaDataNotificationForTokenMovement	Steuert, welche Neuzuordnungen von Token, die während einer Metadatenzusammenführung auftreten, Rückrufe erzeugen. Verwenden Sie die IMetaDataEmit::SetHandler-Methode, um die IMapToken-Schnittstelle festzulegen.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorNotificationForTokenMovement-Enumeration enthalten.
MetaDataSetENC	Steuert das Verhalten von ENC (Edit-and-Continue, Bearbeiten und Fortfahren). Es kann jeweils nur ein Verhaltensmodus festgelegt werden.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorSetENC-Enumeration enthalten. Der Wert ist keine Bitmaske.
MetaDataErrorIfEmitOutOfOrder	Steuert, welche Fehler bei falscher Ausgabereihenfolge Rückrufe erzeugen. Eine falsche Ausgabereihenfolge der Metadaten ist nicht schwerwiegend. Wenn Sie jedoch Metadaten in einer Reihenfolge ausgeben, die vom Metadatenmodul bevorzugt wird, sind die Metadaten kompakter und können daher effizienter durchsucht werden. Verwenden Sie die IMetaDataEmit::SetHandler-Methode, um die IMetaDataError-Schnittstelle festzulegen.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorErrorIfEmitOutOfOrder-Enumeration enthalten.
MetaDataImportOption	Steuert, welche Arten von Elementen, die während eines ENC gelöscht wurden, von einem Enumerator abgerufen werden.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorImportOptions-Enumeration-Enumeration enthalten.
MetaDataThreadSafetyOptions	Steuert, ob das Metadatenmodul Reader-/Writersperren erhält und so die Threadsicherheit sicherstellt. Standardmäßig geht das Modul davon aus, dass es sich beim Zugriff um einen Singlethread des Aufrufers handelt ist, sodass keine Sperren abgerufen werden. Die Clients sind bei der Verwendung der Metadaten-API für die Beibehaltung der richtigen Threadsynchronisierung verantwortlich.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorThreadSafetyOptions-Enumeration enthalten. Der Wert ist keine Bitmaske.
MetaDataGenerateTCEAdapters	Steuert, ob das Type Library Importer-Tool TCE-Adapter (Tightly Coupled Event, eng verknüpfte Ereignisse) für COM-Verbindungspunktcontainer generieren soll.	Muss eine Variante des Typs BOOL sein. Wenn pValue auf true festgelegt ist, generiert das Type Library Importer-Tool die TCE-Adapter.
MetaDataTypeLibImportNamespace	Gibt einen nicht standardmäßigen Namespace für die Typbibliothek an, die importiert wird.	Muss entweder ein NULL-Wert oder eine Variante des Typs BSTRS sein. Wenn für pValue der Wert NULL lautet, wird der aktuelle Namespace auf NULL festgelegt. Andernfalls wird der aktuelle Namespace auf die Zeichenfolge festgelegt, die im BSTR-Typ der Variante vorhanden ist.
MetaDataLinkerOptions	Steuert, ob der Linker eine Assembly oder eine .NET-Framework-Moduldatei generieren soll.	Muss eine Variante des Typs UI4 sein und eine Kombination der Werte der CorLinkerOptions-Enumeration enthalten.
MetaDataRuntimeVersion	Gibt die Version der Common Language Runtime an, anhand derer dieses Abbild erstellt wurde. Die Version wird als Zeichenfolge gespeichert, z. B. "v1.0.3705".	Muss ein NULL-Wert, ein VT_EMPTY-Wert oder eine Variante des Typs BSTRS sein. Wenn pValue NULL ist, wird die Laufzeitversion auf NULL festgelegt. Wenn pValue VT_EMPTY ist, wird die Version auf einen Standardwert festgelegt, der aus der Version von "Mscorwks.dll" gezogen wird, in der der Metadatencode ausgeführt wird. Andernfalls wird die Laufzeitversion auf die Zeichenfolge festgelegt, die im BSTR-Typ der Variante enthalten ist.
MetaDataMergerOptions	Gibt Optionen zum Zusammenführen von Metadaten an.	Muss eine Variante vom Typ UI4 sein und eine Kombination der Werte der MergeFlags-Enumeration enthalten, die in der CorHdr.h-Datei beschrieben ist.