Denominar ensamblados de interoperabilidad primarios

Con el fin de que sea fácil de reconocer, el nombre que elija para un ensamblado de interoperabilidad primario 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 primario tiene efectos significativos en el ámbito del ensamblado y su uso por varias aplicaciones.

El nombre se define al generar el ensamblado de interoperabilidad primario. Normalmente un ensamblado de interoperabilidad primario 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 primarios.

Elementos de nomenclatura

Los ensamblados de interoperabilidad primarios 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.Nombredelabiblioteca para identificar un ensamblado de interoperabilidad primario. Por ejemplo, para identificar por completo la biblioteca de tipos MyTypeLib editada por MyCompany, se puede reemplazar el nombre predeterminado del archivo de ensamblado (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 primario, 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 primario 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

Conceptos

Crear ensamblados de interoperabilidad primarios

Generar ensamblados de interoperabilidad primarios

Personalizar ensamblados de interoperabilidad primarios

Distribuir ensamblados de interoperabilidad primarios para desarrolladores