Compartilhar via


Empacotamento de um Assembly para COM

Desenvolvedores COM podem se beneficiar as seguintes informações sobre os tipos gerenciados que pretendem incorporar em seus aplicativos:

  • Uma lista dos tipos de aplicativos do COM podem consumir.

    Alguns tipos gerenciados são invisíveis COM; Alguns são visíveis, mas não pode ser criado; e alguns são visíveis e pode ser criado. Um assembly pode abranger qualquer combinação de tipos invisíveis visíveis não pode ser criados e pode ser criados. Para completude, identifique os tipos em um assembly que você pretende expor COM, especialmente quando esses tipos são um subconjunto dos tipos expostos para o.NET Framework.

    Para obter informações adicionais, consulte qualificação.NET tipos de interoperação.

  • Instruções de versionamento

    Classes gerenciadas que implementam a interface de classe (uma COM interop interface gerado) estão sujeitos a restrições de controle de versão.

    Para obter diretrizes sobre como usar a interface de classe, consulte apresentando a Interface de classe.

  • Instruções de implantação

    Assemblies de nomes fortes são assinados por um editor podem ser instalados no cache global de assemblies. Assemblies assinados devem ser instalados na máquina do usuário, como conjuntos privados.

    Para obter informações adicionais, consulte As considerações de segurança do Assembly.

  • Inclusão de biblioteca de tipo

    A maioria dos tipos requerem quando consumido por um aplicativo COM uma biblioteca de tipos. Você pode gerar uma biblioteca de tipos ou ter desenvolvedores COM a realizar esta tarefa. O Windows Software Development Kit (SDK) fornece as seguintes opções para gerar uma biblioteca de tipo:

    • Exportador da biblioteca de tipos

    • Classe de TypeLibConverter

    • Ferramenta de registro do assembly

    • .Ferramenta de instalação de serviços NET

    Independentemente do mecanismo escolhido, apenas tipos públicos definidos no assembly que você fornecer estão incluídos na biblioteca de tipos gerados.

    Você pode empacotar uma biblioteca de tipos, como um arquivo separado ou incorporá-lo como arquivo de recurso Win32 dentro de um.Aplicativo baseado em NET. Microsoft Visual Basic 6.0 realizado essa tarefa para você automaticamente. No entanto, ao usar Microsoft Visual Basic 2005, você deve incorporar manualmente a biblioteca de tipos. Para obter instruções, consulte como: Incorpore bibliotecas de tipo como recursos Win32.Aplicativos baseados em NET.

Exportador da biblioteca de tipos

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

Classe de TypeLibConverter

O TypeLibConverter classe, localizado na System.Runtime.Interop namespace, converte as classes e interfaces contidos em um assembly para uma biblioteca de tipos COM. Essa API produz o mesmo tipo de informação como o exportador da biblioteca, descrito na seção anterior.

O TypeLibConverter classe implementa o Interface de ITypeLibConverter.

Ferramenta de registro do assembly

O Ferramenta de registro do Assembly (Regasm. exe) pode gerar e registrar a biblioteca de tipos ao aplicar o /tlb: opção. Clientes COM exigem que as bibliotecas de tipo seja instalado no registro do Windows. Sem essa opção, Regasm. exe registra somente os tipos em um assembly, não a biblioteca de tipos. Registrar os tipos em um assembly e registrar a biblioteca de tipos são atividades distintas.

.Ferramenta de instalação de serviços NET

The .Ferramenta de instalação de serviços NET (RegSvcs. exe) Adiciona classes gerenciadas para serviços de componentes do Windows 2000 e combina várias tarefas com uma única ferramenta. Além de carregar e registrar um assembly, para regsvcs. exe pode gerar, registrar e instalar a biblioteca de tipos em um aplicativo do COM+ 1.0 existente.

Consulte também

Tarefas

Como: Incorpore bibliotecas de tipo como recursos Win32.Aplicativos baseados em NET

Referência

Tlbexp. exe (exportador da biblioteca)

TypeLibConverter

ITypeLibConverter

Conceitos

Expondo.NET Framework para COM

Qualificação.NET tipos de interoperação

Apresentando a Interface de classe

Considerações sobre segurança do assembly

Registrar Assemblies com