IMetaDataImport, interface

  • Article

Fournit des méthodes pour importer et manipuler les métadonnées existantes à partir d'un fichier exécutable portable (PE) ou d'une autre source, comme une bibliothèque de types ou un fichier binaire de métadonnées autonome au moment de l'exécution.

Méthodes

Méthode Description
CloseEnum, méthode Ferme l'énumérateur avec le handle spécifié.
CountEnum, méthode Obtient le nombre d'éléments dans l'énumérateur avec le handle spécifié.
EnumCustomAttributes, méthode Énumère la liste des jetons de définition d'attributs personnalisés associée au type ou membre spécifié.
EnumEvents, méthode Énumère les jetons de définition d'événements pour le jeton TypeDef spécifié.
EnumFields, méthode Énumère les jetons FieldDef pour le type référencé par le jeton TypeDef spécifié.
EnumFieldsWithName, méthode Énumère les jetons FieldDef du type spécifié avec le nom spécifié.
EnumInterfaceImpls, méthode Énumère les jetons MethodDef représentant des implémentations d'interface.
EnumMemberRefs, méthode Énumère les jetons MemberRef représentant les membres du type spécifié.
EnumMembers, méthode Énumère les jetons MemberRef représentant les membres du type spécifié.
EnumMembersWithName, méthode Énumère les jetons MemberDef représentant les membres du type spécifié avec le nom spécifié.
EnumMethodImpls, méthode Énumère les jetons MethodBody et MethodDeclaration représentant les méthodes du type spécifié.
EnumMethods, méthode Énumère les jetons MethodDef représentant les méthodes du type spécifié.
EnumMethodSemantics, méthode Énumère les propriétés et les événements de modification de propriétés auxquels la méthode spécifiée est associée.
EnumMethodsWithName, méthode Énumère les méthodes portant le nom spécifié et définies par le type référencé par le jeton TypeDef spécifié.
EnumModuleRefs, méthode Énumère les jetons ModuleRef qui représentent des modules importés.
EnumParams, méthode Énumère les jetons ParamDef représentant les paramètres de la méthode référencée par le jeton MethodDef spécifié.
EnumPermissionSets, méthode Énumère les autorisations pour les objets inclus dans une portée des métadonnées spécifiée.
EnumProperties, méthode Énumère les jetons PropertyDef représentant les propriétés du type référencé par le jeton TypeDef spécifié.
EnumSignatures, méthode Énumère les jetons Signature représentant des signatures autonomes dans la portée actuelle.
EnumTypeDefs, méthode Énumère les jetons TypeDef représentant tous les types au sein la portée actuelle.
EnumTypeRefs, méthode Énumère les jetons TypeRef définis dans la portée des métadonnées actuelle.
EnumTypeSpecs, méthode Énumère les jetons TypeSpec définis dans la portée des métadonnées actuelle.
EnumUnresolvedMethods, méthode Énumère les jetons MemberDef représentant les méthodes non résolues dans la portée des métadonnées actuelle.
EnumUserStrings, méthode Énumère les jetons String représentant des chaînes codées en dur dans la portée des métadonnées actuelle.
FindField, méthode Obtient le jeton FieldDef pour le champ qui est membre du type spécifié et qui porte le nom spécifié et possède la signature de métadonnées spécifiée.
FindMember, méthode Obtient un pointeur vers le jeton MemberDef pour le membre défini par le type spécifié avec le nom et la signature de métadonnées spécifiés.
FindMemberRef, méthode Obtient un pointeur vers le jeton MemberRef pour le membre défini par le type spécifié avec le nom et la signature de métadonnées spécifiés.
FindMethod, méthode Obtient un pointeur vers le jeton MethodDef pour la méthode définie par le type spécifié avec le nom et la signature de métadonnées spécifiés.
FindTypeDefByName, méthode Obtient un pointeur vers le jeton de métadonnées TypeDef pour le type avec le nom spécifié.
FindTypeRef, méthode Obtient un pointeur vers le jeton de métadonnées TypeRef qui référence le type dans l'étendue de recherche spécifiée avec le nom spécifié.
GetClassLayout, méthode Obtient les informations de disposition pour la classe référencée par le jeton TypeDef spécifié.
GetCustomAttributeByName, méthode Obtient la valeur de l'attribut personnalisé, en fonction de son nom.
GetCustomAttributeProps, méthode Obtient la valeur de l'attribut personnalisé, en fonction de son jeton de métadonnées.
GetEventProps, méthode Obtient les informations de métadonnées (notamment le type déclarant, les méthodes d’ajout et de suppression pour les délégués et tous les indicateurs et autres données associés) pour l’événement représenté par le jeton d’événement spécifié.
GetFieldMarshal, méthode Obtient un pointeur vers le type natif non managé du champ représenté par le jeton de métadonnées Field spécifié.
GetFieldProps, méthode Obtient les métadonnées associées au champ référencé par le jeton FieldDef spécifié.
GetInterfaceImplProps, méthode Obtient un pointeur vers les jetons de métadonnées du type qui implémente la méthode spécifiée et de l'interface qui déclare cette méthode.
GetMemberProps, méthode Obtient les informations de métadonnées (notamment le nom, le signature binaire et l'adresse virtuelle relative) du membre du type référencé par le jeton de métadonnées spécifié.
GetMemberRefProps, méthode Obtient les métadonnées associées au membre référencé par le jeton spécifié.
GetMethodProps, méthode Obtient les métadonnées associées à la méthode référencée par le jeton MethodDef spécifié.
GetMethodSemantics, méthode Obtient un pointeur vers la relation entre la méthode référencée par le jeton MethodDef spécifié et la paire propriété-événement référencée par le jeton EventProp spécifié.
GetModuleFromScope, méthode Obtient un pointeur vers le jeton de métadonnées pour le module référencé dans la portée de métadonnées actuelle.
GetModuleRefProps, méthode Obtient le nom du module référencé par le jeton de métadonnées spécifié.
GetNameFromToken, méthode Obtient le nom UTF-8 de l'objet référencé par le jeton de métadonnées spécifié.
GetNativeCallConvFromSig, méthode Obtient la convention d’appel native pour la méthode représentée par le pointeur de signature spécifié.
GetNestedClassProps, méthode Obtient le jeton TypeDef pour le type parent englobant du type imbriqué spécifié.
GetParamForMethodIndex, méthode Obtient un pointeur vers le jeton qui représente le paramètre à la position ordinale spécifiée dans la séquence des paramètres de méthode pour la méthode représentée par le jeton MethodDef spécifié.
GetParamProps, méthode Obtient les valeurs de métadonnées pour le paramètre référencé par le jeton ParamDef spécifié.
GetPermissionSetProps, méthode Obtient les métadonnées associées au System.Security.PermissionSet représenté par le jeton Permission spécifié.
GetPinvokeMap Obtient un jeton ModuleRef pour représenter l'assembly cible d'un appel PInvoke.
GetPropertyProps, méthode Obtient les métadonnées associées à la propriété représentée par le jeton spécifié.
GetRVA, méthode Obtient le décalage de l'adresse virtuelle relative de l'objet de code représenté par le jeton spécifié.
GetScopeProps, méthode Obtient le nom et éventuellement l'identificateur de version de l'assembly ou du module dans la portée de métadonnées actuelle.
GetSigFromToken, méthode Obtient la signature de métadonnées binaires associée au jeton spécifié.
GetTypeDefProps, méthode Retourne des informations de métadonnées pour le type représenté par le jeton TypeDef spécifié.
GetTypeRefProps, méthode Obtient les métadonnées associées au type référencé par le jeton TypeRef spécifié.
GetTypeSpecFromToken, méthode Obtient la signature de métadonnées binaires de la spécification de type représentée par le jeton spécifié.
GetUserString, méthode Obtient la chaîne littérale représentée par le jeton de métadonnées spécifié.
IsGlobal, méthode Obtient une valeur qui indique si le champ, la méthode ou le type représenté(e) par le jeton de métadonnées spécifié a une portée globale.
IsValidToken, méthode Obtient une valeur indiquant si le jeton spécifié contient une référence valide à un objet de code.
ResetEnum, méthode Réinitialise l'énumérateur spécifié à la position spécifiée.
ResolveTypeRef, méthode Obtient des informations de type pour le type référencé par le jeton TypeRef spécifié.

Remarques

La vocation première de la conception de l'interface IMetaDataImport est d'être utilisée par les outils et services qui importent des informations de type (par exemple, les outils de développement) ou qui gèrent des composants déployés (par exemple, les services de résolution/d'activation). Les méthodes IMetaDataImport appartiennent aux catégories de tâches suivantes :

  • Énumération des collections d'éléments dans la portée des métadonnées.

  • Recherche d'un élément qui possède un ensemble spécifique de caractéristiques.

  • Obtention des propriétés d'un élément spécifié.

  • Les méthodes Get sont conçues spécifiquement pour retourner les propriétés à valeur unique d'un élément de métadonnées. Quand la propriété est une référence à un autre élément, un jeton est retourné pour cet élément. Tout type d'entrée de pointeur peut être NULL pour indiquer que la valeur particulière n'est pas demandée. Pour obtenir les propriétés qui sont essentiellement des objets de collection (par exemple, la collection des interfaces qu’une classe implémente), utilisez les méthodes d’énumération.

Configuration requise

Plateformes : Consultez Configuration requise.

En-tête : Cor.h

Bibliothèque : utilisée comme ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible à partir de la version 1.0

Voir aussi