Freigeben über

IMetaDataImport-Schnittstelle

Stellt Methoden zum Importieren und Bearbeiten vorhandener Metadaten aus einer portablen ausführbaren Datei (PE) oder einer anderen Quelle bereit, z. B. einer Typbibliothek oder einer eigenständigen Laufzeitmetadaten-Binärdatei.

Methods

Method Description
CloseEnum-Methode Schließt den Enumerator mit dem angegebenen Handle.
CountEnum-Methode Ruft die Anzahl der Elemente im Enumerator mit dem angegebenen Handle ab.
EnumCustomAttributes-Methode Liste der benutzerdefinierten Attributdefinitionstoken aufgelistet, die dem angegebenen Typ oder Element zugeordnet sind.
EnumEvents-Methode Listet Ereignisdefinitionstoken für das angegebene TypeDef-Token auf.
EnumFields-Methode Aufzählt FieldDef-Token für den Typ, auf den vom angegebenen TypeDef-Token verwiesen wird.
EnumFieldsWithName-Methode Listet FieldDef-Token des angegebenen Typs mit dem angegebenen Namen auf.
EnumInterfaceImpls-Methode Aufzählt MethodDef-Token, die Schnittstellenimplementierungen darstellen.
EnumMemberRefs-Methode Listet MemberRef-Token auf, die Member des angegebenen Typs darstellen.
EnumMembers-Methode Listet MemberDef-Token auf, die Member des angegebenen Typs darstellen.
EnumMembersWithName-Methode Listet MemberDef-Token auf, die Member des angegebenen Typs mit dem angegebenen Namen darstellen.
EnumMethodImpls-Methode Aufzählt MethodBody- und MethodDeclaration-Token, die Methoden des angegebenen Typs darstellen.
EnumMethods-Methode Aufzählt MethodDef-Token, die Methoden des angegebenen Typs darstellen.
EnumMethodSemantics-Methode Listet die Eigenschaften und die Eigenschaftsänderungsereignisse auf, mit denen die angegebene Methode verknüpft ist.
EnumMethodsWithName-Methode Listet Methoden auf, die den angegebenen Namen aufweisen und durch den Typ definiert werden, auf den durch das angegebene TypeDef-Token verwiesen wird.
EnumModuleRefs-Methode Aufzählt ModuleRef-Token, die importierte Module darstellen.
EnumParams-Methode Aufzählt ParamDef-Token, die die Parameter der Methode darstellen, auf die vom angegebenen MethodDef-Token verwiesen wird.
EnumPermissionSets-Methode Listet Berechtigungen für die Objekte in einem angegebenen Metadatenbereich auf.
EnumProperties-Methode Aufzählt PropertyDef-Token, die die Eigenschaften des Typs darstellen, auf die vom angegebenen TypeDef-Token verwiesen wird.
EnumSignatures-Methode Listet Signaturtoken auf, die eigenständige Signaturen im aktuellen Bereich darstellen.
EnumTypeDefs-Methode Listet TypeDef-Token auf, die alle Typen innerhalb des aktuellen Bereichs darstellen.
EnumTypeRefs-Methode Listet TypeRef-Token auf, die im aktuellen Metadatenbereich definiert sind.
EnumTypeSpecs-Methode Listet TypeSpec-Token auf, die im aktuellen Metadatenbereich definiert sind.
EnumUnresolvedMethods-Methode Listet MemberDef-Token auf, die die nicht aufgelösten Methoden im aktuellen Metadatenbereich darstellen.
EnumUserStrings-Methode Listet Zeichenfolgentoken auf, die hartcodierte Zeichenfolgen im aktuellen Metadatenbereich darstellen.
FindField-Methode Ruft das FieldDef-Token für das Feld ab, das mitglied des angegebenen Typs ist, und weist den angegebenen Namen und die Metadatensignatur auf.
FindMember-Methode Ruft einen Zeiger auf das MemberDef-Token für das Element ab, das durch den angegebenen Typ mit dem angegebenen Namen und der Metadatensignatur definiert ist.
FindMemberRef-Methode Ruft einen Zeiger auf das MemberRef-Token für das vom angegebenen Typ definierte Element mit dem angegebenen Namen und der Metadatensignatur ab.
FindMethod-Methode Ruft einen Zeiger auf das MethodDef-Token für die vom angegebenen Typ definierte Methode mit dem angegebenen Namen und der Metadatensignatur ab.
FindTypeDefByName-Methode Ruft einen Zeiger auf das TypeDef-Metadatentoken für den Typ mit dem angegebenen Namen ab.
FindTypeRef-Methode Ruft einen Zeiger auf das TypeRef-Metadatentoken ab, das auf den Typ im angegebenen Suchbereich mit dem angegebenen Namen verweist.
GetClassLayout-Methode Ruft Layoutinformationen für die Klasse ab, auf die durch das angegebene TypeDef-Token verwiesen wird.
GetCustomAttributeByName-Methode Ruft den Wert des benutzerdefinierten Attributs mit dem Namen ab.
GetCustomAttributeProps-Methode Ruft den Wert des benutzerdefinierten Attributs ab, je nach metadatentoken.
GetEventProps-Methode Ruft Metadateninformationen (einschließlich des deklarierenden Typs, der Methoden zum Hinzufügen und Entfernen von Stellvertretungen und allen Flags und anderen zugeordneten Daten) für das Ereignis ab, das durch das angegebene Ereignistoken dargestellt wird.
GetFieldMarshal-Methode Ruft einen Zeiger auf den systemeigenen, nicht verwalteten Typ des Felds ab, das durch das angegebene Feldmetadatentoken dargestellt wird.
GetFieldProps-Methode Ruft Metadaten ab, die mit dem Feld verknüpft sind, auf das vom angegebenen FieldDef-Token verwiesen wird.
GetInterfaceImplProps-Methode Ruft einen Zeiger auf die Metadatentoken für den Typ ab, der die angegebene Methode implementiert, und für die Schnittstelle, die diese Methode deklariert.
GetMemberProps-Methode Ruft Metadateninformationen (einschließlich Name, binärer Signatur und relativer virtueller Adresse) des Typelements ab, auf das durch das angegebene Metadatentoken verwiesen wird.
GetMemberRefProps-Methode Ruft Metadaten ab, die mit dem Element verknüpft sind, auf das vom angegebenen Token verwiesen wird.
GetMethodProps-Methode Ruft die Metadaten ab, die der Methode zugeordnet sind, auf die vom angegebenen MethodDef-Token verwiesen wird.
GetMethodSemantics-Methode Ruft einen Zeiger auf die Beziehung zwischen der Methode ab, auf die durch das angegebene MethodDef-Token verwiesen wird, und der gekoppelten Eigenschaft und dem Ereignis, auf das vom angegebenen EventProp-Token verwiesen wird.
GetModuleFromScope-Methode Ruft einen Zeiger auf das Metadatentoken für das Modul ab, auf das im aktuellen Metadatenbereich verwiesen wird.
GetModuleRefProps-Methode Ruft den Namen des Moduls ab, auf das durch das angegebene Metadatentoken verwiesen wird.
GetNameFromToken-Methode Ruft den UTF-8-Namen des Objekts ab, auf das durch das angegebene Metadatentoken verwiesen wird.
GetNativeCallConvFromSig-Methode Ruft die systemeigene Aufrufkonvention für die Methode ab, die durch den angegebenen Signaturzeiger dargestellt wird.
GetNestedClassProps-Methode Ruft das TypeDef-Token für den umschließenden übergeordneten Typ des angegebenen geschachtelten Typs ab.
GetParamForMethodIndex-Methode Ruft einen Zeiger auf das Token ab, das den Parameter an der angegebenen Ordnungsposition in der Sequenz von Methodenparametern für die Methode darstellt, die durch das angegebene MethodDef-Token dargestellt wird.
GetParamProps-Methode Ruft Metadatenwerte für den Parameter ab, auf den durch das angegebene ParamDef-Token verwiesen wird.
GetPermissionSetProps-Methode Ruft die Metadaten ab, die dem System.Security.PermissionSet zugeordnet sind, dargestellt durch das angegebene Berechtigungstoken.
GetPinvokeMap Ruft ein ModuleRef-Token ab, das die Zielassembly eines PInvoke-Aufrufs darstellt.
GetPropertyProps-Methode Ruft die Metadaten ab, die der Eigenschaft zugeordnet sind, die durch das angegebene Token dargestellt wird.
GetRVA-Methode Ruft den Offset der relativen virtuellen Adresse des Codeobjekts ab, das durch das angegebene Token dargestellt wird.
GetScopeProps-Methode Ruft den Namen und optional den Versionsbezeichner der Assembly oder des Moduls im aktuellen Metadatenbereich ab.
GetSigFromToken-Methode Ruft die binäre Metadatensignatur ab, die dem angegebenen Token zugeordnet ist.
GetTypeDefProps-Methode Gibt Metadateninformationen für den Typ zurück, der durch das angegebene TypeDef-Token dargestellt wird.
GetTypeRefProps-Methode Ruft die Metadaten ab, die dem Typ zugeordnet sind, auf den durch das angegebene TypeRef-Token verwiesen wird.
GetTypeSpecFromToken-Methode Ruft die binäre Metadatensignatur der Typspezifikation ab, die durch das angegebene Token dargestellt wird.
GetUserString-Methode Ruft die Literalzeichenfolge ab, die durch das angegebene Metadatentoken dargestellt wird.
IsGlobal-Methode Ruft einen Wert ab, der angibt, ob das Feld, die Methode oder der Typ, der durch das angegebene Metadatentoken dargestellt wird, globalen Bereich aufweist.
IsValidToken-Methode Ruft einen Wert ab, der angibt, ob das angegebene Token einen gültigen Verweis auf ein Codeobjekt enthält.
ResetEnum-Methode Setzt den angegebenen Enumerator auf die angegebene Position zurück.
ResolveTypeRef-Methode Ruft Typinformationen für den Typ ab, auf den vom angegebenen TypeRef-Token verwiesen wird.

Remarks

Der Entwurf der IMetaDataImport Schnittstelle soll hauptsächlich von Tools und Diensten verwendet werden, die Typinformationen (z. B. Entwicklungstools) oder die Verwaltung bereitgestellter Komponenten (z. B. Auflösungs-/Aktivierungsdienste) importieren. Die Methoden werden IMetaDataImport in die folgenden Aufgabenkategorien unterteilt:

  • Aufzählen von Auflistungen von Elementen im Metadatenbereich.

  • Suchen eines Elements, das über einen bestimmten Satz von Merkmalen verfügt.

  • Abrufen von Eigenschaften eines angegebenen Elements.

  • Die Get-Methoden sind speziell darauf ausgelegt, einwertige Eigenschaften eines Metadatenelements zurückzugeben. Wenn die Eigenschaft ein Verweis auf ein anderes Element ist, wird ein Token für dieses Element zurückgegeben. Jeder Zeigereingabetyp kann NULL sein, um anzugeben, dass der jeweilige Wert nicht angefordert wird. Verwenden Sie zum Abrufen von Eigenschaften, die im Wesentlichen Auflistungsobjekte sind (z. B. die Auflistung von Schnittstellen, die eine Klasse implementiert), die Enumerationsmethoden.

Requirements

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: Cor.h

Bibliothek: CorGuids.lib

Siehe auch

  • Last updated on