Partilhar via

IMetaDataImport Interface

  • Artigo

Fornece métodos para importar e manipular metadados existentes a partir de um ficheiro executável portátil (PE) ou de outra origem, como uma biblioteca de tipos ou um binário autónomo de metadados de tempo de execução.

Métodos

Método Descrição
Método CloseEnum Fecha o enumerador com a alça especificada.
Método CountEnum Obtém o número de elementos no enumerador com a alça especificada.
Método EnumCustomAttributes Enumera uma lista de tokens de definição de atributos personalizados associados ao tipo ou membro especificado.
Método EnumEvents Enumera tokens de definição de eventos para o token TypeDef especificado.
Método EnumFields Enumera tokens FieldDef para o tipo referenciado pelo token TypeDef especificado.
Método EnumFieldsWithName Enumera tokens FieldDef do tipo especificado com o nome especificado.
Método EnumInterfaceImpls Enumera tokens MethodDef que representam implementações de interface.
Método EnumMemberRefs Enumera tokens MemberRef que representam membros do tipo especificado.
Método EnumMembers Enumera tokens MemberDef que representam membros do tipo especificado.
Método EnumMembersWithName Enumera tokens MemberDef que representam membros do tipo especificado com o nome especificado.
Método EnumMethodImpls Enumera os tokens MethodBody e MethodDeclaration que representam métodos do tipo especificado.
Método EnumMethods Enumera tokens MethodDef que representam métodos do tipo especificado.
Método EnumMethodSemantics Enumera as propriedades e os eventos de alteração de propriedades aos quais o método especificado está relacionado.
Método EnumMethodsWithName Enumera métodos que têm o nome especificado e que são definidos pelo tipo referenciado pelo token TypeDef especificado.
Método EnumModuleRefs Enumera tokens ModuleRef que representam módulos importados.
Método EnumParams Enumera tokens paramDef que representam os parâmetros do método referenciado pelo token MethodDef especificado.
Método EnumPermissionSets Enumera permissões para os objetos num âmbito de metadados especificado.
Método EnumProperties Enumera tokens PropertyDef que representam as propriedades do tipo referenciado pelo token TypeDef especificado.
Método EnumSignatures Enumera tokens de assinatura que representam assinaturas autónomas no âmbito atual.
Método EnumTypeDefs Enumera tokens TypeDef que representam todos os tipos no âmbito atual.
Método EnumTypeRefs Enumera tokens TypeRef definidos no âmbito de metadados atual.
Método EnumTypeSpecs Enumera tokens TypeSpec definidos no âmbito de metadados atual.
Método EnumUnresolvedMethods Enumera tokens MemberDef que representam os métodos não resolvidos no âmbito de metadados atual.
Método EnumUserStrings Enumera tokens de Cadeia que representam cadeias de carateres codificadas no âmbito de metadados atual.
Método FindField Obtém o token FieldDef para o campo que é membro do tipo especificado e tem o nome especificado e a assinatura de metadados.
Método FindMember Obtém um ponteiro para o token MemberDef para o membro definido pelo tipo especificado com o nome especificado e a assinatura de metadados.
Método FindMemberRef Obtém um ponteiro para o token MemberRef para o membro definido pelo tipo especificado com o nome especificado e a assinatura de metadados.
Método FindMethod Obtém um ponteiro para o token MethodDef para o método definido pelo tipo especificado com o nome especificado e a assinatura de metadados.
Método FindTypeDefByName Obtém um ponteiro para o token de metadados TypeDef para o tipo com o nome especificado.
Método FindTypeRef Obtém um ponteiro para o token de metadados TypeRef que referencia o tipo no âmbito de pesquisa especificado com o nome especificado.
Método GetClassLayout Obtém informações de esquema para a classe referenciada pelo token TypeDef especificado.
Método GetCustomAttributeByName Obtém o valor do atributo personalizado, dado o respetivo nome.
Método GetCustomAttributeProps Obtém o valor do atributo personalizado, dado o respetivo token de metadados.
Método GetEventProps Obtém informações de metadados (incluindo o tipo de declaração, os métodos de adicionar e remover para delegados e quaisquer sinalizadores e outros dados associados) para o evento representado pelo token de evento especificado.
Método GetFieldMarshal Obtém um ponteiro para o tipo nativo e não gerido do campo representado pelo token de metadados de campo especificado.
Método GetFieldProps Obtém metadados associados ao campo referenciado pelo token FieldDef especificado.
Método GetInterfaceImplProps Obtém um ponteiro para os tokens de metadados para o tipo que implementa o método especificado e para a interface que declara esse método.
Método GetMemberProps Obtém informações de metadados (incluindo o nome, assinatura binária e endereço virtual relativo) do tipo membro referenciado pelo token de metadados especificado.
Método GetMemberRefProps Obtém metadados associados ao membro referenciado pelo token especificado.
Método GetMethodProps Obtém os metadados associados ao método referenciado pelo token MethodDef especificado.
Método GetMethodSemantics Obtém um ponteiro para a relação entre o método referenciado pelo token MethodDef especificado e a propriedade emparelhada e o evento referenciados pelo token EventProp especificado.
Método GetModuleFromScope Obtém um ponteiro para o token de metadados do módulo referenciado no âmbito de metadados atual.
Método GetModuleRefProps Obtém o nome do módulo referenciado pelo token de metadados especificado.
Método GetNameFromToken Obtém o nome UTF-8 do objeto referenciado pelo token de metadados especificado.
Método GetNativeCallConvFromSig Obtém a convenção de chamada nativa para o método representado pelo ponteiro de assinatura especificado.
Método GetNestedClassProps Obtém o token TypeDef para o tipo principal incluído do tipo aninhado especificado.
Método GetParamForMethodIndex Obtém um ponteiro para o token que representa o parâmetro na posição ordinal especificada na sequência de parâmetros do método para o método representado pelo token MethodDef especificado.
Método GetParamProps Obtém valores de metadados para o parâmetro referenciado pelo token ParamDef especificado.
Método GetPermissionSetProps Obtém os metadados associados ao System.Security.PermissionSet representados pelo token de Permissão especificado.
GetPinvokeMap Obtém um token ModuleRef para representar a assemblagem de destino de uma chamada PInvoke.
Método GetPropertyProps Obtém os metadados associados à propriedade representada pelo token especificado.
Método GetRVA Obtém o desvio do endereço virtual relativo do objeto de código representado pelo token especificado.
Método GetScopeProps Obtém o nome e, opcionalmente, o identificador da versão da assemblagem ou módulo no âmbito de metadados atual.
Método GetSigFromToken Obtém a assinatura de metadados binários associada ao token especificado.
Método GetTypeDefProps Devolve informações de metadados para o tipo representado pelo token TypeDef especificado.
Método GetTypeRefProps Obtém os metadados associados ao tipo referenciado pelo token TypeRef especificado.
GetTypeSpecFromToken Method Obtém a assinatura de metadados binários da especificação de tipo representada pelo token especificado.
Método GetUserString Obtém a cadeia literal representada pelo token de metadados especificado.
Método IsGlobal Obtém um valor que indica se o campo, método ou tipo representado pelo token de metadados especificado tem um âmbito global.
Método IsValidToken Obtém um valor que indica se o token especificado contém uma referência válida a um objeto de código.
Método ResetEnum Repõe o enumerador especificado para a posição especificada.
Método ResolveTypeRef Obtém informações de tipo para o tipo referenciado pelo token TypeRef especificado.

Observações

A estrutura da IMetaDataImport interface destina-se principalmente a ser utilizada por ferramentas e serviços que irão importar informações do tipo (por exemplo, ferramentas de desenvolvimento) ou gerir componentes implementados (por exemplo, serviços de resolução/ativação). Os métodos em enquadram-se nas IMetaDataImport seguintes categorias de tarefas:

  • Enumerar coleções de itens no âmbito de metadados.

  • Localizar um item que tenha um conjunto específico de características.

  • Obter propriedades de um item especificado.

  • Os métodos Get foram concebidos especificamente para devolver propriedades de valor único de um item de metadados. Quando a propriedade é uma referência a outro item, é devolvido um token para esse item. Qualquer tipo de entrada de ponteiro pode ser NULL para indicar que o valor específico não está a ser pedido. Para obter propriedades que são essencialmente objetos de coleção (por exemplo, a coleção de interfaces que uma classe implementa), utilize os métodos de enumeração.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: Cor.h

Biblioteca: Utilizado como recurso no MsCorEE.dll

.NET Framework Versões: Disponível desde 1.0

Ver também