Nomes de Assemblies de interoperabilidade primários

Para reconhecimento fácil, o nome que você selecionar para um assembly de interoperabilidade primária deve se parecer com o nome original de biblioteca de tipo COM e seja específico para os desenvolvedores de guia para o assembly correto. Como ocorre com outros assemblies, o nome de um assembly de interoperabilidade primária tem um significativo impacto sobre o escopo do assembly e usar por vários aplicativos.

Você pode definir o nome ao gerar o assembly de interoperabilidade primário. Você geralmente pode gerar um assembly de interoperabilidade primária, importando uma biblioteca de tipos. Para obter detalhes sobre a importação de uma biblioteca de tipos, consulte Gerando Primary Interop Assemblies.

Nomeando elementos

Assemblies de interoperabilidade primária devem ser assinados com nomes fortes usando a criptografia de chave pública padrão. Além da chave pública, há dois elementos essenciais de nomes:

• Nome do arquivo do assembly.

  O nome do arquivo do assembly deve coincidir com o nome do assembly (não incluindo a extensão de nome de arquivo, como, por exemplo, exe ou. dll). Por padrão, o processo de importação utiliza o nome da biblioteca de tipo, em vez do nome de arquivo da biblioteca de tipos, para produzir o nome do assembly e o nome do arquivo. O nome da biblioteca de tipo e o nome de arquivo da biblioteca de tipo não são necessariamente idênticos. Por exemplo, se você importar a biblioteca de tipos do MyTypeLib contida no arquivo MyComponent.tlb, seu nome de assembly padrão torna-se MyTypeLib e o nome do arquivo do assembly de padrão se torna MyTypeLib.dll.

  Como diretriz geral, use o nome_do_fornecedor.O nome da biblioteca combinação para identificar um assembly de interoperabilidade primária. Por exemplo, para identificar totalmente a biblioteca de tipos do MyTypeLib, publicada pela MyCompany, substitua o nome de arquivo do assembly do padrão (MyTypeLib.dll) com MyCompany.MyTypeLib.dll ao importar a biblioteca de tipos.

• Nome do namespace.

  Quando você importa uma biblioteca de tipos, o processo usa o nome da biblioteca de tipos para produzir o nome do namespace. Substituindo o namespace padrão durante o processo de importação, você pode especificar o nome do namespace. Use a mesma convenção de nomeação para o namespace (nome_do_fornecedor.Nome da biblioteca) que você pode usar o nome do assembly.

Considerações de nomeação.

Considere as seguintes questões de nomenclatura:

• Em algum momento no futuro pode planeja implementar uma versão gerenciada de uma tecnologia de COM existente. Nesse caso, considere o uso de nome_do_fornecedor.O nome da biblioteca.Interop a combinação de namespace para o seu assembly de interoperabilidade primários, reservando nome_do_fornecedor.O nome da biblioteca para o assembly gerenciado.

• Sua estratégia de nomeação também pode manter a compatibilidade de origem entre a biblioteca de tipos COM original e o assembly de interoperabilidade primário usando o nome de assembly do padrão, o nome do arquivo e o nome do namespace. Ao menos descritivo, essa estratégia é útil para bibliotecas conhecidas, como, por exemplo, ADODB no Microsoft Visual Basic 6.0 (a biblioteca do ADO).

Consulte também

Conceitos

Produção 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