Compartilhar via


Como: Criar Wrappers COM

Você pode criar wrappers do modelo de objeto componente (COM) usando recursos deMicrosoft Visual Studio 2005 ou o.NET Framework ferramentas Tlbimp. exe e Regasm. exe Ambos os métodos geram dois tipos de wrappers COM:

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

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

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

Quebra automática de objetos COM em um aplicativo gerenciado

Para criar um runtime callable wrapper usando Visual Studio

  1. Abra o projeto do aplicativo gerenciado.

  2. Sobre o projeto menu, clique em Mostrar todos os arquivos.

  3. No menu Project, escolha Add Reference.

  4. Na caixa de diálogo Add Reference, clique na COM , selecione o componente que você deseja usar e clique em OK.

    Em Solution Explorer, observe que o componente COM é adicionado à pasta de 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 2005 ou um Using a instrução para Visual C# 2005.

Observação

Se você quiser programar os componentes de Microsoft Office, primeiro instale o Microsoft Office Primary Interop Assemblies (PIAs) do Centro de Download da Microsoft.Na etapa 4, selecione a versão mais recente da biblioteca de objeto disponível para o produto do Office que você deseja, como o Microsoft Word 11.0 Object Library.Microsoft Excel Technology Sample

Para criar um usando o runtime callable wrapper.Ferramentas do NET Framework

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

Gerenciado de quebra automática de objetos em um aplicativo nativo

Para criar um COM callable wrapper usando Visual Studio

  1. Crie um projeto de biblioteca de classe para a classe gerenciada que você deseja executar em código nativo. A classe deve ter um construtor padrão.

    Verifique se você possui um número de versão de quatro partes completa para seu assembly 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 os números de versão, consulte Versionamento de Assembly.

  2. No menu Project, clique em Properties..

  3. Clique na guia Compile.

  4. Marque a caixa de seleção Register for COM interop.

Quando você constrói o projeto, o assembly é automaticamente registrado para interoperabilidade COM. Se você estiver criando um aplicativo nativo Visual Studio 2005, você pode usar o assembly clicando Add Reference sobre o projeto menu.

Para criar um usando o COM callable wrapper.Ferramentas do NET Framework

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

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

Consulte também

Conceitos

Runtime Callable Wrapper

COM Callable Wrapper