Denominar ensamblados de interoperabilidad primaria

Con el fin de que sea fácil de reconocer, el nombre que elija para un ensamblado de interoperabilidad primaria debería asemejarse al nombre original de la biblioteca de tipos COM, y ser lo suficientemente específico para dirigir a los programadores al ensamblado correcto. Como sucede con otros ensamblados, el nombre de un ensamblado de interoperabilidad primaria tiene efectos significativos en el ámbito del ensamblado y su uso por varias aplicaciones.

El nombre se define al generar el ensamblado de interoperabilidad primaria. Normalmente un ensamblado de interoperabilidad primaria se genera importando una biblioteca de tipos. Para obtener información sobre la importación de una biblioteca de tipos, vea Generar ensamblados de interoperabilidad primaria.

Elementos de nomenclatura

Los ensamblados de interoperabilidad primaria deben estar firmados con nombres seguros mediante criptografía de clave pública estándar. Además de la clave pública, hay dos elementos de denominación esenciales:

• Nombre del archivo del ensamblado

  El nombre del archivo del ensamblado debe coincidir con el nombre del ensamblado (sin incluir la extensión del nombre del archivo, como .exe o .dll). De manera predeterminada, el proceso de importación utiliza el nombre de la biblioteca de tipos, y no el nombre del archivo de la biblioteca de tipos, para crear el nombre del ensamblado y el nombre del archivo. El nombre de la biblioteca de tipos y el nombre del archivo de la biblioteca de tipos no son necesariamente idénticos. Por ejemplo, si se importa la biblioteca de tipos MyTypeLib que está en el archivo MyComponent.tlb, el nombre predeterminado del ensamblado será MyTypeLib y el nombre predeterminado del archivo del ensamblado será MyTypeLib.dll.

  Como norma general, se puede utilizar la combinación Nombredelproveedor.Nombre delabiblioteca para identificar un ensamblado de interoperabilidad primaria. Por ejemplo, para identificar por completo la biblioteca de tipos MyTypeLib editada por MyCompany, se puede reemplazar el nombre predeterminado del archivo (MyTypeLib.dll) por MyCompany.MyTypeLib.dll al importar la biblioteca de tipos.

• Nombre del espacio de nombres

  Cuando se importa una biblioteca de tipos, el proceso utiliza el nombre de la biblioteca de tipos para crear el nombre del espacio de nombres. Mediante el reemplazo del espacio de nombres predeterminado, se puede especificar el nombre del espacio de nombres. Se puede utilizar para el espacio de nombres la misma convención de nomenclatura que la utilizada para el nombre del ensamblado (Nombredelproveedor.Nombre de la biblioteca).

Consideraciones sobre nomenclatura

Considere las siguientes cuestiones de nomenclatura:

• En el futuro podría planear implementar una versión administrada de tecnología COM ya existente. En ese caso, considere utilizar la combinación del espacio de nombres Nombredelproveedor.Nombredelabiblioteca.Interoperativo para el ensamblado de interoperabilidad primaria, reservando Nombredelproveedor.Nombredelabiblioteca para el ensamblado administrado.
• La estrategia de nomenclatura puede también mantener compatibilidad de origen entre la biblioteca de tipos COM original y el ensamblado de interoperabilidad primaria mediante la utilización del nombre de ensamblado, el nombre del archivo y el nombre del espacio de nombres predeterminados. Aunque es menos descriptiva, esta estrategia es útil para bibliotecas bien conocidas, como ADODB de Microsoft Visual Basic 6.0 (la biblioteca ADO).

Vea también

Crear ensamblados de interoperabilidad primaria Generar ensamblados de interoperabilidad primaria Personalizar ensamblados de interoperabilidad primaria Distribuir ensamblados de interoperabilidad primaria para programadores