Adicionar referências às bibliotecas de tipos

Note

Este artigo descreve orientações sobre a interoperabilidade COM do .NET Framework que utilizam referências legadas do Visual Studio a bibliotecas de tipos e assemblies de interoperabilidade primários. Para o .NET moderno, utilize a geração de origem COM ou a API ComWrappers. Para mais informações, consulte interoperabilidade COM.

O Visual Studio gera um assembly interop contendo metadados quando adicionas uma referência a uma biblioteca de tipos. Se estiver disponível um assembly principal de interoperabilidade, o Visual Studio utiliza o conjunto existente antes de gerar um novo conjunto de interoperabilidade.

Adicione uma referência a uma biblioteca de tipos no Visual Studio

  1. Instala o DLL COM ou ficheiro EXE no teu computador, a menos que um ficheiro Windows Setup.exe faça a instalação por ti.

  2. Escolhe Project, Adicionar Referência.

  3. No Gestor de Referências, escolha COM.

  4. Selecione a biblioteca de tipos da lista ou procure o ficheiro .tlb.

  5. Escolha OK.

  6. No Explorador de Soluções, abre o menu de atalhos da referência que acabaste de adicionar e depois escolhe Propriedades.

  7. Na janela de Propriedades, certifique-se de que a propriedade Embed Interop Types está definida como True. Isto faz com que o Visual Studio incorpore informação de tipos de COM nos seus executáveis, eliminando a necessidade de implementar assemblies de interoperabilidade primária com a sua aplicação.

Note

As opções do menu e das caixas de diálogo podem variar consoante a versão do Visual Studio que está a usar.

Adicionar uma referência a uma biblioteca de tipos para compilação em linha de comandos

  1. Gerar um conjunto de interoperabilidade conforme descrito em Gerar conjuntos de interoperabilidade a partir de bibliotecas de tipos.

  2. Utilize a opção do compilador -link (Opções do Compilador C#) ou -link (Visual Basic) com o nome do assembly de interoperabilidade para incorporar informações de tipo para tipos COM nos executáveis.

Ver também