IMetaDataImport-Schnittstelle

  • Artikel

Stellt Methoden zum Importieren und Bearbeiten vorhandener Metadaten aus einer portablen ausführbaren Datei (PE-Datei) oder einer anderen Quelle wie einer Typbibliothek oder einer eigenständigen Laufzeit-Metadatenbinärdatei bereit

Methoden

Methode Beschreibung
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 Zählt eine Liste der benutzerdefinierten Attributdefinitionstoken mit dem angegebenen Typ oder Element auf.
EnumEvents-Methode Zählt Ereignisdefinitionstoken für das angegebene TypeDef-Token auf.
EnumFields-Methode Zählt FieldDef-Token für den Typ auf, auf den durch das angegebene TypeDef-Token verwiesen wird.
EnumFieldsWithName-Methode Zählt FieldDef-Token des angegebenen Typs mit dem angegebenen Namen auf.
EnumInterfaceImpls-Methode Zählt MethodDef-Token auf, die Schnittstellenimplementierungen darstellen.
EnumMemberRefs-Methode Zählt MemberRef-Token auf, die Elemente des angegebenen Typs darstellen.
EnumMembers-Methode Zählt MemberDef-Token auf, die Elemente des angegebenen Typs darstellen.
EnumMembersWithName-Methode Zählt MemberDef-Token auf, die Elemente des angegebenen Typs mit dem angegebenen Namen darstellen.
EnumMethodImpls-Methode Zählt MethodBody- und MethodDeclaration-Token auf, die Methoden des angegebenen Typs darstellen.
EnumMethods-Methode Zählt MethodDef-Token auf, die Methoden des angegebenen Typs darstellen.
EnumMethodSemantics-Methode Zählt die Eigenschaften und die Eigenschaftenänderungsereignisse auf, auf die sich die angegebene Methode bezieht.
EnumMethodsWithName-Methode Zählt Methoden auf, die den angegebenen Namen aufweisen und durch den Typ definiert sind, auf den durch das angegebene TypeDef-Token verwiesen wird.
EnumModuleRefs-Methode Zählt ModuleRef-Token auf, die importierte Module darstellen.
EnumParams-Methode Zählt ParamDef-Token auf, die die Parameter der Methode darstellen, auf die vom angegebenen MethodDef-Token verwiesen wird.
EnumPermissionSets-Methode Zählt Berechtigungen für die Objekte in einem angegebenen Metadatenbereich auf.
EnumProperties-Methode Zählt PropertyDef-Token auf, die die Eigenschaften des Typs darstellen, auf den vom angegebenen TypeDef-Token verwiesen wird.
EnumSignatures-Methode Zählt Signaturtoken auf, die eigenständige Signaturen im aktuellen Bereich darstellen.
EnumTypeDefs-Methode Zählt TypeDef-Token auf, die alle Typen innerhalb des aktuellen Bereichs darstellen.
EnumTypeRefs-Methode Zählt TypeRef-Token auf, die im aktuellen Metadatenbereich definiert sind.
EnumTypeSpecs-Methode Zählt TypeSpec-Token auf, die im aktuellen Metadatenbereich definiert sind.
EnumUnresolvedMethods-Methode Zählt MemberDef-Token auf, die die nicht aufgelösten Methoden im aktuellen Metadatenbereich darstellen.
EnumUserStrings-Methode Zählt String-Token auf, die hartcodierte Zeichenfolgen im aktuellen Metadatenbereich darstellen.
FindField-Methode Ruft das FieldDef-Token für das Feld ab, das ein Element des angegebenen Typs ist und den angegebenen Namen und die Metadatensignatur aufweist.
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 Element ab, das durch den angegebenen Typ mit dem angegebenen Namen und der Metadatensignatur definiert ist.
FindMethod-Methode Ruft einen Zeiger auf das MethodDef-Token für die Methode ab, die durch den angegebenen Typ mit dem angegebenen Namen und der Metadatensignatur definiert ist.
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 vom angegebenen TypeDef-Token verwiesen wird.
GetCustomAttributeByName-Methode Ruft den Wert des benutzerdefinierten Attributs ab, wenn sein Name angegeben wurde.
GetCustomAttributeProps-Methode Ruft den Wert des benutzerdefinierten Attributs ab, wenn sein Metadatentoken angegeben wurde.
GetEventProps-Methode Ruft Metadateninformationen (z. B. den deklarierenden Typ, die Hinzufügungs- und Entfernungsmethoden für Delegaten und alle Kennzeichnungen und sonstigen 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 Field-Metadatentoken dargestellt wird.
GetFieldProps-Methode Ruft Metadaten ab, die dem Feld zugeordnet sind, auf das durch das angegebene 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 (z. B. den Namen, die binäre Signatur und die relative virtuelle Adresse) des Typmelements ab, auf das durch das angegebene Metadatentoken verwiesen wird.
GetMemberRefProps-Methode Ruft Metadaten ab, die dem Element zugeordnet sind, auf das durch das angegebene Token verwiesen wird.
GetMethodProps-Methode Ruft die Metadaten ab, die der Methode zugeordnet sind, auf die durch das angegebene MethodDef-Token verwiesen wird.
GetMethodSemantics-Methode Ruft einen Zeiger auf die Beziehung zwischen der Methode ab, auf die vom angegebenen MethodDef-Token verwiesen wird, und der gepaarten Eigenschaft und dem Ereignis, auf die 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 vom angegebenen Metadatentoken verwiesen wird.
GetNameFromToken-Methode Ruft den UTF-8-Namen des Objekts ab, auf das vom angegebenen 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 einschließenden übergeordneten Typ des angegebenen geschachtelten Typs ab.
GetParamForMethodIndex-Methode Ruft einen Zeiger auf das Token ab, das den Parameter an der angegebenen Ordinalposition in der Sequenz der Methodenparameter 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, das durch das angegebene Berechtigungstoken dargestellt wird.
GetPinvokeMap Ruft ein ModuleRef-Token zum Darstellen der Zielassembly eines PInvoke-Aufrufs ab.
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 durch das angegebene Token dargestellten Codeobjekts ab.
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 TypeDef-Token verwiesen wird.
GetTypeSpecFromToken-Methode Ruft die binäre Metadatensignatur der Typspezifikation ab, die durch das angegebene Token dargestellt wird.
GetUserString-Methode Ruft das Zeichenfolgenliteral ab, das durch das angegebene Metadatentoken dargestellt wird.
IsGlobal-Methode Ruft einen Wert ab, der angibt, ob für das durch das angegebene Metadatentoken dargestellte Feld, die Methode oder den Typ der globale Bereich gilt.
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 der angegebene Position zurück.
ResolveTypeRef-Methode Ruft Typinformationen für den Typ ab, auf den durch das angegebene TypeRef-Token verwiesen wird.

Bemerkungen

Das Design der IMetaDataImport-Schnittstelle soll primär von Tools und Diensten verwendet werden, die Typinformationen importieren (z. B. Entwicklungstools) oder Bereitstellungskomponenten (z. B. Auflösungs-/Aktivierungsdienste) verwalten. Die Methoden in IMetaDataImport können in die folgenden Aufgabenkategorien eingeteilt werden:

  • Auzählen von Elementauflistungen im Metadatenbereich.

  • Suchen nach einem Element, das über eine bestimmte Sammlung von Merkmalen verfügt.

  • Abrufen von Eigenschaften eines angegebenen Elements.

  • Die Get-Methoden wurden speziell dafür entwickelt, um 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 betreffende Wert nicht angefordert wird. Verwenden Sie zum Abrufen von Eigenschaften, die im Wesentlichen Auflistungsobjekte sind (z. B. die Auflistung der Schnittstellen, die eine Klasse implementiert) die Enumerationsmethoden.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: Cor.h

Bibliothek: Als Ressource in „MsCorEE.dll“ verwendet

.NET Framework-Versionen: Seit Version 1.0 verfügbar

Siehe auch