Compartilhar via

Empacotando um assembly do .NET Framework para uso com COM

Os desenvolvedores com COM podem se beneficiar das seguintes informações sobre os tipos gerenciados que planejam incorporar em seu aplicativo:

  • Uma lista de tipos que os aplicativos COM podem consumir

    Alguns tipos gerenciados são invisíveis para COM; alguns são visíveis, mas não creatáveis; e alguns são visíveis e cretáveis. Um assembly pode incluir qualquer combinação de tipos invisíveis, visíveis, não instanciáveis e instanciáveis. Para fins de integridade, identifique os tipos em um assembly que você pretende expor ao COM, especialmente quando esses tipos são um subconjunto dos tipos expostos ao .NET Framework.

    Para obter informações adicionais, consulte Qualificando tipos .NET para interoperação.

  • Instruções de controle de versão

    As classes gerenciadas que implementam a interface de classe (uma interface gerada por interoperabilidade COM) estão sujeitas a restrições de controle de versão.

    Para obter diretrizes sobre como usar a interface de classe, consulte Introdução à interface de classe.

  • Instruções de implementação

    Assemblies de nome forte que são assinados por um editor podem ser instalados no cache de assembly global. Assemblies não assinados devem ser instalados no computador do usuário como assemblies particulares.

    Para obter mais informações, consulte Considerações sobre segurança de assembly.

  • Inclusão de biblioteca de tipos

    A maioria dos tipos exige uma biblioteca de tipos quando consumida por um aplicativo COM. Você pode gerar uma biblioteca de tipos ou fazer com que os desenvolvedores com executem essa tarefa. O SDK do Windows fornece as seguintes opções para gerar uma biblioteca de tipos:

    Independentemente do mecanismo escolhido, somente os tipos públicos definidos no assembly fornecido são incluídos na biblioteca de tipos gerada.

Para obter instruções, consulte Como inserir bibliotecas de tipos como recursos Win32 em aplicativos .NET-Based.

Exportador da Biblioteca de Tipos

O Exportador de Biblioteca de Tipos (Tlbexp.exe) é uma ferramenta de linha de comando que converte as classes e interfaces contidas em um assembly em uma biblioteca de tipos COM. Depois que as informações de tipo da classe estiverem disponíveis, os clientes COM poderão criar uma instância da classe .NET e chamar os métodos da instância, como se fosse um objeto COM. Tlbexp.exe converte um conjunto inteiro de uma só vez. Não é possível usar Tlbexp.exe para gerar informações de tipo para um subconjunto dos tipos definidos em um assembly.

Classe TypeLibConverter

A TypeLibConverter classe, localizada no namespace System.Runtime.Interop , converte as classes e interfaces contidas em um assembly em uma biblioteca de tipos COM. Essa API produz as mesmas informações de tipo que o Exportador de Biblioteca de Tipos, descrito na seção anterior.

A classe TypeLibConverter implementa o ITypeLibConverter.

Ferramenta de Registro de Assembly

A Ferramenta de Registro de Assembly (Regasm.exe) pode gerar e registrar uma biblioteca de tipos quando você aplica a opção /tlb:. Os clientes COM exigem que as bibliotecas de tipos sejam instaladas no Registro do Windows. Sem essa opção, Regasm.exe registra apenas os tipos em um assembly, não na biblioteca de tipos. Registrar os tipos em um assembly e registrando a biblioteca de tipos são atividades distintas.

Ferramenta de Instalação do .NET Services

A Ferramenta de Instalação dos Serviços do .NET (Regsvcs.exe) adiciona classes gerenciadas aos Serviços de Componentes do Windows 2000 e combina várias tarefas em uma única ferramenta. Além de carregar e registrar um assembly, Regsvcs.exe pode gerar, registrar e instalar a biblioteca de tipos em um aplicativo COM+ 1.0 existente.

Consulte também

  • Last updated on