Condividi tramite

Interfaccia IMetaDataImport

  • Articolo

Fornisce metodi per importare e modificare i metadati esistenti da un file eseguibile portabile (PE) o da un'altra origine, ad esempio una libreria dei tipi o un binario dei metadati di runtime autonomo.

Metodi

Metodo Descrizione
Metodo CloseEnum Chiude l'enumeratore con l'handle specificato.
Metodo CountEnum Ottiene il numero di elementi nell'enumeratore con l'handle specificato.
Metodo EnumCustomAttributes Enumera un elenco di token di definizione di attributo personalizzato associati al tipo o al membro specificato.
Metodo EnumEvents Enumera i token di definizione di evento per il token TypeDef specificato.
Metodo EnumFields Enumera i token FieldDef per il tipo a cui fa riferimento il token TypeDef specificato.
Metodo EnumFieldsWithName Enumera i token FieldDef del tipo specificato con il nome specificato.
Metodo EnumInterfaceImpls Enumera i token MethodDef che rappresentano le implementazioni dell'interfaccia.
Metodo EnumMemberRefs Enumera i token MemberRef che rappresentano i membri del tipo specificato.
Metodo EnumMembers Enumera i token MemberDef che rappresentano i membri del tipo specificato.
Metodo EnumMembersWithName Enumera i token MemberDef che rappresentano i membri del tipo specificato con il nome specificato.
Metodo EnumMethodImpls Enumera i token MethodBody e MethodDeclaration che rappresentano i metodi del tipo specificato.
Metodo EnumMethods Enumera i token MethodDef che rappresentano i metodi del tipo specificato.
Metodo EnumMethodSemantics Enumera le proprietà e gli eventi di modifica delle proprietà a cui è correlato il metodo specificato.
Metodo EnumMethodsWithName Enumera i metodi che hanno il nome specificato e che sono definiti dal tipo a cui fa riferimento il token TypeDef specificato.
Metodo EnumModuleRefs Enumera i token ModuleRef che rappresentano i moduli importati.
Metodo EnumParams Enumera i token ParamDef che rappresentano i parametri del metodo a cui fa riferimento il token MethodDef specificato.
Metodo EnumPermissionSets Enumera le autorizzazioni per gli oggetti in un ambito dei metadati specificato.
Metodo EnumProperties Enumera i token PropertyDef che rappresentano le proprietà del tipo a cui fa riferimento il token TypeDef specificato.
Metodo EnumSignatures Enumera i token Signature che rappresentano le firme autonome nell'ambito corrente.
Metodo EnumTypeDefs Enumera i token TypeDef che rappresentano tutti i tipi all'interno dell'ambito corrente.
Metodo EnumTypeRefs Enumera i token TypeRef definiti nell'ambito dei metadati corrente.
Metodo EnumTypeSpecs Enumera i token TypeSpec definiti nell'ambito dei metadati corrente.
Metodo EnumUnresolvedMethods Enumera i token MemberDef che rappresentano i metodi non risolti nell'ambito dei metadati corrente.
Metodo EnumUserStrings Enumera i token String che rappresentano le stringhe specificate a livello di codice (hard-coded) nell'ambito dei metadati corrente.
Metodo FindField Ottiene un token FieldDef per il campo membro del tipo specificato a cui corrispondono il nome e la firma dei metadati specificati.
Metodo FindMember Ottiene un puntatore al token MemberDef per il membro definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo FindMemberRef Ottiene un puntatore al token MemberRef per il membro definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo FindMethod Ottiene un puntatore al token MethodDef per il metodo definito dal tipo indicato con il nome e la firma dei metadati specificati.
Metodo FindTypeDefByName Ottiene un puntatore al token TypeDef per il tipo con il nome specificato.
Metodo FindTypeRef Ottiene un puntatore al token di metadati TypeRef che fa riferimento al tipo con il nome specificato nell'ambito di ricerca indicato.
Metodo GetClassLayout Ottiene le informazioni sul layout per la classe a cui fa riferimento il token TypeDef specificato.
Metodo GetCustomAttributeByName Ottiene il valore dell'attributo personalizzato, dato il relativo nome.
Metodo GetCustomAttributeProps Ottiene il valore dell'attributo personalizzato, dato il relativo token di metadati.
Metodo GetEventProps Ottiene informazioni sui metadati, tra cui il tipo dichiarante, i metodi di aggiunta ed eliminazione per i delegati, i flag e gli altri dati associati, per l'evento rappresentato dal token specificato.
Metodo GetFieldMarshal Ottiene un puntatore al tipo nativo non gestito del campo rappresentato dal token di metadati specificato.
Metodo GetFieldProps Ottiene i metadati associati al campo a cui fa riferimento il token FieldDef specificato.
Metodo GetInterfaceImplProps Ottiene un puntatore ai token di metadati per il tipo che implementa il metodo specificato e per l'interfaccia che dichiara tale metodo.
Metodo GetMemberProps Ottiene le informazioni sui metadati, inclusi il nome, la firma binaria e l'indirizzo virtuale relativo, del membro del tipo a cui fa riferimento il token di metadati specificato.
Metodo GetMemberRefProps Ottiene i metadati associati al membro a cui fa riferimento il token specificato.
Metodo GetMethodProps Ottiene i metadati associati al metodo a cui fa riferimento il token MethodDef specificato.
Metodo GetMethodSemantics Ottiene un puntatore alla relazione tra il metodo a cui fa riferimento il token MethodDef specificato e l'associazione di proprietà ed evento a cui fa riferimento il token EventProp specificato.
Metodo GetModuleFromScope Ottiene un puntatore al token di metadati per il modulo a cui si fa riferimento nell'ambito dei metadati corrente.
Metodo GetModuleRefProps Ottiene il nome del modulo a cui fa riferimento il token di metadati specificato.
Metodo GetNameFromToken Ottiene il nome in formato UTF-8 dell'oggetto a cui fa riferimento il token di metadati specificato.
Metodo GetNativeCallConvFromSig Ottiene la convenzione di chiamata nativa per il metodo rappresentato dal puntatore a firma specificato.
Metodo GetNestedClassProps Ottiene il token TypeDef per il tipo dell'elemento padre che contiene il tipo annidato specificato.
Metodo GetParamForMethodIndex Ottiene un puntatore al token che rappresenta il parametro nella posizione ordinale specificata nella sequenza di parametri di metodo relativi al metodo rappresentato dal token MethodDef specificato.
Metodo GetParamProps Ottiene i valori di metadati relativi al parametro a cui fa riferimento il token ParamDef specificato.
Metodo GetPermissionSetProps Ottiene i metadati associati all'oggetto System.Security.PermissionSet rappresentato dal token Permission specificato.
GetPinvokeMap Ottiene un token ModuleRef per rappresentare l'assembly di destinazione di una chiamata PInvoke.
Metodo GetPropertyProps Ottiene i metadati associati alla proprietà rappresentata dal token specificato.
Metodo GetRVA Ottiene l'offset dell'indirizzo virtuale relativo dell'oggetto codice rappresentato dal token specificato.
Metodo GetScopeProps Ottiene il nome ed eventualmente l'identificatore di versione dell'assembly o del modulo nell'ambito dei metadati corrente.
Metodo GetSigFromToken Ottiene la firma binaria dei metadati associata al token specificato.
Metodo GetTypeDefProps Restituisce le informazioni sui metadati per il tipo rappresentato dal token TypeDef specificato.
Metodo GetTypeRefProps Ottiene i metadati associati al tipo a cui fa riferimento il token TypeRef specificato.
Metodo GetTypeSpecFromToken Ottiene la firma binaria dei metadati della specifica del tipo rappresentata dal token indicato.
Metodo GetUserString Ottiene la stringa letterale rappresentata dal token di metadati specificato.
Metodo IsGlobal Ottiene un valore che indica se il campo, il metodo o il tipo rappresentato dal token di metadati specificato ha ambito globale.
Metodo IsValidToken Ottiene un valore che indica se il token specificato contiene un riferimento valido a un oggetto codice.
Metodo ResetEnum Reimposta l'enumeratore specificato nella posizione specificata.
Metodo ResolveTypeRef Ottiene le informazioni per il tipo a cui fa riferimento il token TypeRef specificato.

Commenti

L'interfaccia IMetaDataImport è progettata principalmente per essere usata da strumenti e servizi che importeranno informazioni sul tipo, ad esempio strumenti di sviluppo, o gestiranno componenti distribuiti, quali servizi di risoluzione o attivazione. I metodi di IMetaDataImport rientrano nelle seguenti categorie di attività:

  • Enumerazione di raccolte di elementi nell'ambito dei metadati.

  • Ricerca di un elemento con una serie specifica di caratteristiche.

  • Recupero delle proprietà di un elemento specificato.

  • I metodi Get sono progettati specificamente per restituire le proprietà a valore singolo di un elemento dei metadati. Quando la proprietà è un riferimento a un altro elemento, viene restituito un token per tale elemento. Qualunque tipo di input del puntatore può essere NULL per indicare che il valore in questione non è richiesto. Per ottenere proprietà che siano essenzialmente oggetti Collection, ad esempio la raccolta di interfacce implementate da una classe, usare i metodi di enumerazione.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: Cor.h

Libreria: Usato come risorsa in MsCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 1.0

Vedi anche