Acerca de los ensamblados privados
Un ensamblado privado es un ensamblado que se implementa con una aplicación y está disponible para el uso exclusivo de esa aplicación. Es decir, otras aplicaciones no comparten el ensamblado privado. Los ensamblados privados son uno de los métodos que se pueden usar para crear aplicaciones aisladas. Para obtener más información, vea Acerca de las aplicaciones aisladas y ensamblados en paralelo.
Los ensamblados privados deben diseñarse para trabajar en paralelo con otras versiones del ensamblado en el sistema. Para obtener más información, vea Directrices para crear ensamblados en paralelo.
Los ensamblados privados deben ir acompañados de un manifiesto de ensamblado. Tenga en cuenta que las restricciones de nombre se aplican al empaquetar un archivo DLL como un ensamblado privado para dar cabida a la forma en que Windows busca ensamblados privados. Al buscar ensamblados privados, el método recomendado es incluir el manifiesto de ensamblado en el archivo DLL como un recurso. En este caso, el identificador de recurso debe ser igual a 1 y el nombre del ensamblado privado puede ser el mismo que el nombre del archivo DLL. Por ejemplo, si el nombre del archivo DLL es MICROSOFT.WINDOWS.MYSAMPLE.DLL, el valor del atributo name usado en el elemento assemblyIdentity del manifiesto también puede ser Microsoft.Windows.mysample. Un método alternativo de búsqueda de ensamblados privados es proporcionar el manifiesto del ensamblado en un archivo independiente. En este caso, el nombre del ensamblado y su manifiesto deben ser diferentes del nombre del archivo DLL. Por ejemplo, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest y Microsoft.Windows.mysample.dll. Para obtener más información sobre cómo se buscan ensamblados privados en paralelo, vea Secuencia de búsqueda de ensamblados.
Los ensamblados privados se instalan en una carpeta de la estructura de directorios de la aplicación. Normalmente, esta es la carpeta que contiene el archivo ejecutable de la aplicación. Los ensamblados privados se pueden implementar en la misma carpeta que la aplicación, en una carpeta con el mismo nombre que el ensamblado o en una subcarpeta específica del lenguaje con el mismo nombre que el ensamblado. Por ejemplo, use una de las siguientes estructuras de directorio para implementar un ensamblado privado, Microsoft.tools.pop, sin ningún idioma especificado.
| Estructura de directorios | Descripción |
|---|---|
| APPDIR\MICROSOFT.TOOLS.POP.DLL | El manifiesto se implementa como un recurso en el archivo DLL. |
| Appdir\Microsoft.Tools.Pop.MANIFEST | El manifiesto se implementa como un archivo independiente. |
| APPDIR\MICROSOFT.TOOLS.POP\MICROSOFT.TOOLS.POP.DLL | El manifiesto se implementa como un recurso en el archivo DLL, que se encuentra en una subcarpeta que tiene el nombre del ensamblado. |
| Appdir\Microsoft.Tools.Pop\Microsoft.Tools.Pop.MANIFEST | El manifiesto se implementa como un archivo independiente en una subcarpeta que tiene el nombre del ensamblado. |
Importante
Para las versiones del sistema operativo Windows anteriores a Windows 7 y Windows Server 2008 R2, los ensamblados privados nativos deben implementarse en la carpeta que contiene el archivo ejecutable de la aplicación. No se admite la instalación en una carpeta específica del lenguaje o en la carpeta con el mismo nombre que el ensamblado para los ensamblados privados nativos.
Use una de las siguientes estructuras de directorio para implementar un ensamblado privado, Microsoft.tools.pop, con un lenguaje especificado. En el ejemplo siguiente, el idioma usado por Microsoft.Tools.Pop es inglés (Estados Unidos) y el código de idioma es en-us. Debe sustituir el código de lenguaje DHTML correcto para el ensamblado.
appdir\en-us\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop.MANIFEST
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.DLL
appdir\en-us\Microsoft.tools.pop\Microsoft.tools.pop.MANIFEST
Los ensamblados privados se pueden instalar mediante cualquier método de instalación que pueda copiar el archivo del ensamblado en esta carpeta, como el comando xcopy . Para obtener más información sobre cómo instalar ensamblados privados mediante Windows Installer, vea Instalación de ensamblados Win32.
Los ensamblados privados también se pueden instalar en sistemas operativos anteriores a Windows XP. En este caso, el ensamblado debe estar registrado y en estos sistemas operativos no se usa el manifiesto. Se instala una copia del ensamblado privado en una carpeta privada para el uso exclusivo de la aplicación. Otra versión del ensamblado se puede registrar globalmente en el sistema y estar disponible para cualquier aplicación que se enlace a él. La versión global del ensamblado puede ser la versión instalada con la aplicación o una anterior. Para obtener más información, consulte Redireccionamiento DLL/COM en Windows. Un ensamblado también se puede instalar como un ensamblado compartido para que lo usen varias aplicaciones. Para obtener más información, vea Ensamblados compartidos.
Tenga en cuenta que los pasos para crear un ensamblado privado son idénticos a los de crear un ensamblado compartido con dos excepciones:
- No es necesario firmar un ensamblado privado y publickeyToken no es necesario en el elemento assemblyIdentity del manifiesto del ensamblado.
- Los ensamblados privados se pueden instalar en la carpeta de la aplicación mediante cualquier tecnología de instalación. No es necesario instalar ensamblados privados mediante Windows Installer.