Compartilhar via


Produção de Assemblies de interoperabilidade primários

Assemblies de interoperabilidade primários são fornecidos pelo mesmo editor como a biblioteca de tipos que descrevem e fornecem as definições de oficiais dos tipos definidos com esse tipo de biblioteca. Produção e distribuição de um assembly de interoperabilidade primária são uma etapa essencial em expor componentes COM para o.NET Framework.

Assemblies de interoperabilidade primária devem atender aos seguintes requisitos:

  • Incluir todos os tipos de COM, definidos na biblioteca do tipo original e manter as mesmas identidades GUID.

  • Ser assinado com um nome forte usando o padrão de criptografia de chave pública.

  • Conter a PrimaryInteropAssemblyAttribute atributo.

  • Evite redefinindo os tipos de COM externos.

  • Fazer referência somente outros assemblies de interoperabilidade primária para as dependências externas do COM.

Ter uma definição de tipo único garante que todos os.Aplicativos do NET Framework ligar para o mesmo tipo em tempo de compilação e o tipo é empacotado da mesma maneira em tempo de execução. É importante criar apenas um assembly de interoperabilidade primária para cada biblioteca de tipos COM porque vários assemblies podem introduzir a incompatibilidade de tipo.

Para melhorar a interoperabilidade, você pode personalizar os nomes e o comportamento de empacotamento de tipos individuais. Se você revisar um assembly de interoperabilidade primária após a entrega, incremente o número de versão do assembly para diferenciar versões posteriores.

Consulte também

Conceitos

Nomes de Assemblies de interoperabilidade primários

Gerar Assemblies de interoperabilidade primários

Personalizando os Assemblies de interoperabilidade primários

Distribuir Assemblies de interoperabilidade primária para desenvolvedores

Outros recursos

Assemblies de Interoperabilidade Primários