Como: Criar wrappers COM

Você pode criar wrappers COM (Component Object Model) usando recursos do Visual Studio ou as ferramentas do .NET Framework Tlbimp.exe e Regasm.exe. Ambos os métodos geram dois tipos de wrappers COM:

  • Um Runtime Callable Wrapper de uma biblioteca de tipos para executar um objeto COM em código gerenciado.

  • Um COM Callable Wrapper com as configurações de registro necessárias para executar um objeto gerenciado em um aplicativo nativo.

No Visual Studio, você pode adicionar o wrapper COM como uma referência ao seu projeto.

Encapsular objetos COM em um aplicativo gerenciado

Para criar um wrapper chamável de tempo de execução usando o Visual Studio

  1. Abra o projeto para seu aplicativo gerenciado.

  2. No menu Projeto, clique em Mostrar Todos os Arquivos.

  3. No menu Projeto, clique em Adicionar Referência.

  4. Na caixa de diálogo Adicionar Referência, clique na guia COM, selecione o componente que deseja usar e clique em OK.

    No Gerenciador de Soluções, observe que o componente COM é adicionado à pasta Referências em seu projeto.

Agora você pode escrever código para acessar o objeto COM. Você pode começar declarando o objeto, como com uma Imports instrução para Visual Basic ou uma Using diretiva para C#.

Nota

Se você quiser programar componentes do Microsoft Office, primeiro instale o Microsoft Office Primary Interop Assemblies Redistributable.

Para criar um wrapper chamável em tempo de execução usando ferramentas do .NET Framework

Esta ferramenta cria um assembly que contém metadados de execução para os tipos definidos na biblioteca de tipos original.

Encapsular objetos gerenciados em um aplicativo nativo

Para criar um wrapper chamável COM usando o Visual Studio

  1. Crie um projeto de biblioteca de classes para a classe gerenciada que você deseja executar em código nativo. A classe deve ter um construtor sem parâmetros.

    Verifique se você tem um número de versão completo de quatro partes para sua montagem no arquivo AssemblyInfo. Esse número é necessário para manter o controle de versão no registro do Windows. Para obter mais informações sobre números de versão, consulte Assembly Versioning.

  2. No menu Projeto, clique em Propriedades.

  3. Clique na guia Compilar .

  4. Marque a caixa de seleção Registrar para interoperabilidade COM.

Quando você cria o projeto, o assembly é automaticamente registrado para interoperabilidade COM. Se você estiver criando um aplicativo nativo no Visual Studio, você pode usar o assembly clicando em Adicionar referência no menu Projeto .

Para criar um wrapper chamável COM usando ferramentas do .NET Framework

Execute a ferramenta Regasm.exe (Assembly Registration Tool).

Esta ferramenta lê os metadados do assembly e adiciona as entradas necessárias ao registro. Como resultado, os clientes COM podem criar classes do .NET Framework de forma transparente. Você pode usar o assembly como se fosse uma classe COM nativa.

Você pode executar Regasm.exe em um assembly localizado em qualquer diretório e, em seguida, executar o Gacutil.exe (Global Assembly Cache Tool) para movê-lo para o cache de assembly global. Mover o assembly não invalida as entradas do registro de local, porque o cache global do assembly é sempre examinado se o assembly não for encontrado em outro lugar.

Consulte também

  • Last updated on