Interface IMetaDataImport

  • Artigo

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

Métodos

Método Descrição
Método CloseEnum Fecha o enumerador com o identificador especificado.
Método CountEnum Obtém o número de elementos no enumerador com o identificador especificado.
Método EnumCustomAttributes Enumera uma lista de tokens de definição de atributo personalizados associados ao tipo ou membro especificado.
Método EnumEvents Enumera tokens de definição de evento 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 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 propriedade 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 em um escopo 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 Signature que representam assinaturas autônomas no escopo atual.
Método EnumTypeDefs Enumera tokens TypeDef que representam todos os tipos no escopo atual.
Método EnumTypeRefs Enumera tokens TypeRef definidos no escopo de metadados atual.
Método EnumTypeSpecs Enumera tokens TypeSpec definidos no escopo de metadados atual.
Método EnumUnresolvedMethods Enumera tokens MemberDef que representam os métodos não resolvidos no escopo de metadados atual.
Método EnumUserStrings Enumera tokens String que representam cadeias de caracteres embutidas em código no escopo de metadados atual.
Método FindField Obtém o token FieldDef para o campo que é um membro do tipo especificado e tem o nome e a assinatura de metadados especificados.
Método FindMember Obtém um ponteiro para o token MemberDef para o membro definido pelo tipo especificado com o nome e a assinatura de metadados especificados.
Método FindMemberRef Obtém um ponteiro para o token MemberRef para o membro definido pelo tipo especificado com o nome e a assinatura de metadados especificados.
Método FindMethod Obtém um ponteiro para o token MethodDef para o método definido pelo tipo especificado com o nome e a assinatura de metadados especificados.
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 faz referência ao tipo no escopo de pesquisa especificado com o nome especificado.
Método GetClassLayout Obtém informações de layout para a classe referenciada pelo token TypeDef especificado.
Método GetCustomAttributeByName Obtém o valor do atributo personalizado, dado seu nome.
Método GetCustomAttributeProps Obtém o valor do atributo personalizado, dado seu token de metadados.
Método GetEventProps Obtém informações de metadados (incluindo o tipo de declaração, os métodos de adição e remoção 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 não gerenciado 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, a assinatura binária e o endereço virtual relativo) do membro do tipo 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 escopo 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 pai que inclui o 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 de 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 representado pelo token de permissão especificado.
GetPinvokeMap Obtém um token ModuleRef para representar o assembly 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 deslocamento 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 de versão do assembly ou módulo no escopo de metadados atual.
Método GetSigFromToken Obtém a assinatura de metadados binários associada ao token especificado.
Método GetTypeDefProps Retorna 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.
Método GetTypeSpecFromToken Obtém a assinatura de metadados binários da especificação de tipo representada pelo token especificado.
Método GetUserString Obtém a cadeia de caracteres literal representada pelo token de metadados especificado.
Método IsGlobal Obtém um valor que indica se o campo, o método ou o tipo representado pelo token de metadados especificado tem escopo 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 Redefine 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.

Comentários

O design da interface IMetaDataImport destina-se principalmente a ser usado por ferramentas e serviços que vão importar informações de tipo (por exemplo, ferramentas de desenvolvimento) ou gerenciar componentes implantados (por exemplo, serviços de resolução/ativação). Os métodos em IMetaDataImport se enquadram nas seguintes categorias de tarefa:

  • Enumerando coleções de itens no escopo de metadados.

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

  • Obtendo as propriedades de um item especificado.

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

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: Cor.h

Biblioteca: usada como um recurso na MsCorEE.dll

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também