Compilar um projeto de interoperabilidade

Note

Este artigo descreve orientações de interoperabilidade .NET Framework COM que utilizam assemblies de interoperabilidade legadas e assemblies de interoperabilidade primárias. Para o .NET moderno, utilize a geração de origem COM ou a API ComWrappers. Para mais informações, consulte interoperabilidade COM.

Projetos de interoperabilidade COM que fazem referência a um ou mais assemblies contendo tipos COM importados são compilados como qualquer outro projeto gerenciado. Você pode fazer referência a assemblies de interoperabilidade em um ambiente de desenvolvimento, como o Visual Studio, ou pode fazer referência a eles quando usa um compilador de linha de comando. Em ambos os casos, para compilar corretamente, o assembly de interoperabilidade deve estar no mesmo diretório que os outros arquivos de projeto.

Há duas maneiras de fazer referência a assemblies de interoperabilidade:

  • Tipos de interoperabilidade incorporados: Instrua o compilador a incorporar informações de tipo de um assembly de interoperabilidade no executável. Esta é a técnica recomendada.
  • Implementação de assemblies de interoperabilidade: Crie uma referência padrão para um conjunto de interoperabilidade. Nesse caso, o assembly de interoperabilidade deve ser implantado com seu aplicativo.

As diferenças entre essas duas técnicas são discutidas com mais detalhes em Usando tipos COM em código gerenciado.

A incorporação de tipos de interoperabilidade com o Visual Studio é demonstrada em Passo a passo: Incorporando tipos de assemblies gerenciados no Visual Studio.

Para referenciar um assembly de interoperabilidade com um compilador de linha de comando e incorporar informações de tipo nos seus executáveis, utilize a opção de compilador -link (Opções do compilador C#) ou -link (Visual Basic) e especifique o nome do assembly de interoperabilidade.

Note

Aplicativos Visual C++ não podem incorporar informações de tipo, mas eles podem interoperar com aplicativos ou suplementos que o fazem.

Para compilar um aplicativo que inclui um assembly de interoperabilidade primário quando ele é implantado, use a opção de compilador /reference e especifique o nome do assembly de interoperabilidade.

Ver também