Compartilhar via

Importando uma biblioteca de tipos como um assembly

  • Artigo

Definições de tipo COM geralmente residem em uma biblioteca de tipos. Por outro lado, os compiladores em conformidade com CLS produzem metadados de tipo em um assembly. As duas fontes de informações de tipo são muito diferentes. Este tópico descreve técnicas para a geração de metadados de uma biblioteca de tipos. O assembly resultante é chamado de um assembly de interoperabilidade e as informações de tipo contidas nele permitem que aplicativos do .NET Framework usem tipos COM.

Há duas maneiras de disponibilizar essas informações de tipo para seu aplicativo:

  • Usar assemblies de interoperabilidade somente em tempo de design: começando com o .NET Framework 4, é possível instruir o compilador a inserir informações de tipo do assembly de interoperabilidade no executável. O compilador insere apenas as informações de tipo usadas pelo aplicativo. Não é necessário implantar o assembly de interoperabilidade com o aplicativo. Essa é a técnica recomendada.

  • Implantando assemblies de interoperabilidade: é possível criar uma referência padrão ao assembly de interoperabilidade. Nesse caso, o assembly de interoperabilidade deve ser implantado com o aplicativo. Se você usar essa técnica e não estiver usando um componente COM particular, sempre referencie o PIA (assembly de interoperabilidade primário) publicado pelo autor do componente COM que você pretende incorporar no código gerenciado. Para obter mais informações sobre como produzir e usar assemblies de interoperabilidade primários, consulte Assemblies de interoperabilidade primários.

Quando você usar assemblies de interoperabilidade somente em tempo de design, você pode inserir informações de tipo do assembly de interoperabilidade primário publicado pelo autor do componente COM. No entanto, não é necessário implantar o assembly de interoperabilidade primário com o aplicativo.

Usar assemblies de interoperabilidade somente em tempo de design reduz o tamanho do seu aplicativo, porque a maioria dos aplicativos não usam todos os recursos de um componente COM. O compilador é muito eficiente quando ele insere informações de tipo. Se seu aplicativo usa apenas alguns dos métodos em uma interface COM, o compilador não insere os métodos não utilizados. Quando um aplicativo que inseriu informações de tipo interage com outro aplicativo desse tipo ou interage com um aplicativo que usa um assembly de interoperabilidade primário, o Common Language Runtime usa regras de equivalência de tipo para determinar se dois tipos com o mesmo nome representam o mesmo tipo COM. Você não precisa conhecer essas regras para usar objetos COM. No entanto, se você estiver interessado nas regras, consulte Equivalência de tipos e tipos de interoperabilidade inseridos.

Geração de metadados

Bibliotecas de tipos COM podem ser arquivos autônomos que têm uma extensão .tlb, tais como Loanlib.tlb. Algumas bibliotecas de tipo são inseridas na seção de recursos de um arquivo .dll ou .exe. Outras fontes de informações da biblioteca de tipos são arquivos .olb e .ocx.

Após você localizar a biblioteca de tipos que contém a implementação do seu tipo COM de destino, você tem as seguintes opções para a geração de um assembly de interoperabilidade contendo os metadados de tipo:

  • Visual Studio

    O Visual Studio converte automaticamente os tipos COM em uma biblioteca de tipos para metadados em um assembly. Para instruções, confira Como adicionar referências a bibliotecas de tipos.

  • Importador de Biblioteca de Tipos (Tlbimp.exe)

    O importador da biblioteca de tipos fornece opções de linha de comando para ajustar os metadados no arquivo de interoperabilidade resultante, importa tipos de uma biblioteca de tipos existente e gera um assembly de interoperabilidade e um namespace. Para obter instruções, consulte Como gerar assemblies de interoperabilidade com base em bibliotecas de tipos.

  • Classe System.Runtime.InteropServices.TypeLibConverter

    Essa classe fornece métodos para converter coclasses e interfaces em uma biblioteca de tipos para metadados em um assembly. Ela produz a mesma saída de metadados que Tlbimp.exe. No entanto, ao contrário de Tlbimp.exe, a classe TypeLibConverter pode converter uma biblioteca de tipos na memória em metadados.

  • Wrappers personalizados

    Quando uma biblioteca de tipos não está disponível ou é incorreta, uma opção é criar uma definição duplicada da classe ou interface em código-fonte gerenciado. Em seguida, você compilar o código-fonte com um compilador que tem como alvo o runtime para produzir os metadados em um assembly.

    Para definir tipos COM manualmente, você deve ter acesso aos seguintes itens:

    • Descrições precisas das coclasses e interfaces que estão sendo definidas.

    • Um compilador, assim como o compilador C#, que pode gerar as definições de classe do .NET Framework apropriadas.

    • Conhecimento das regras de conversão de biblioteca de tipos para assembly.

    Escrever um wrapper personalizado é uma técnica avançada. Para obter informações adicionais sobre como gerar um wrapper personalizado, consulte Personalizando wrappers padrão.

Para obter mais informações sobre o processo de importação de interoperabilidade COM, consulte Resumo da conversão de bibliotecas de tipos em assemblies.

Confira também