Compartilhar via

Como: Criar wrappers COM

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

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

Encapsular objetos COM em um aplicativo gerenciado

Para criar um RCW (Runtime Callable Wrapper) usando o Visual Studio

  1. Abra o projeto do 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 você deseja usar e clique em OK.

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

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

Observação

Caso deseje programar componentes do Microsoft Office, primeiro instale os PIAs (Assemblies de Interoperabilidade Primários) do Microsoft Office no Centro de Download da Microsoft.

Para criar um RCW (Runtime Callable Wrapper) usando ferramentas do .NET Framework

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

Encapsular objetos gerenciados em um aplicativo nativo

Para criar um COM Callable Wrapper usando o Visual Studio

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

    Verifique se você tem um número de versão de quatro partes completo para o 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 Controle de versão do assembly.

  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 é registrado automaticamente para a interoperabilidade COM. Se estiver criando um aplicativo nativo no Visual Studio 2005, você poderá usar o assembly clicando em Adicionar Referência no menu Projeto.

Para criar um COM Callable Wrapper usando ferramentas do .NET Framework

Execute a ferramenta Regasm.exe (Ferramenta de Registro de Assembly).

Essa 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. Use o assembly como se ele fosse uma classe COM nativa.

Execute o Regasm.exe em um assembly localizado em qualquer diretório e, em seguida, execute o Gacutil.exe (Ferramenta do Cache de Assembly Global) para movê-lo para o cache de assembly global. A movimentação do assembly não invalida as entradas do Registro de local, porque o cache de assembly global sempre será examinado se o assembly não for encontrado em outro lugar.

Confira também