Registrar manualmente un ensamblado
.NET Framework SDK proporciona la herramienta Instalación de servicios de .NET Framework (Regsvcs.exe) para registrar manualmente un ensamblado que contiene componentes con servicio. Regsvcs.exe es una herramienta de la línea de comandos. También se puede tener acceso a estas características de registro mediante programación con la clase System.EnterpriseServices.RegistrationHelper creando una instancia de la clase RegistrationHelper y utilizando el método InstallAssembly.
Aunque no es siempre necesario, resulta útil registrar los ensamblados manualmente para hacer pruebas en tiempo de diseño. A diferencia del registro dinámico, el proceso manual ofrece comentarios sobre los errores producidos durante la ejecución.
**Nota **Si se crea una aplicación de servidor, se ha de agregar el ensamblado y todos los ensamblados de los que dependa a la caché de ensamblados global mediante Windows Installer para poder utilizar la aplicación de servidor; en caso contrario, la aplicación generará una excepción.
En la tabla siguiente se enumeran los pasos que realiza Regsvcs.exe (o la API) y describe los errores que se pueden producir en cada paso.
| Paso | Error posible | Resultado |
|---|---|---|
| Carga el ensamblado. | El ensamblado no se carga. | Aparecerá un mensaje de error con una descripción. |
| Registra el ensamblado. | El tipo no se registra. | Los ensamblados que no se especifican correctamente provocan una excepción TypeLoadException. |
| Genera una biblioteca de tipos. | La biblioteca no se genera. | Los ensamblados que no se especifican correctamente provocan una excepción TypeLoadException. |
| Llama al método LoadTypeLibrary para registrar la biblioteca de tipos. | Error de la llamada a automatización. | Genera una excepción TypeLoadException. |
| Instala el tipo de biblioteca en la aplicación solicitada. | La herramienta Registro de ensamblados (Regasm.exe) no encuentra la aplicación especificada. | Muestra un mensaje de error que dice que no se encuentra uno de los objetos
Para solucionarlo, confirme la ubicación de la biblioteca de tipos y la aplicación especificadas. |
| Configura la clase. | La herramienta detecta una disparidad en los atributos de servicio durante el registro; por ejemplo, si hay una clase configurada con propiedades en conflicto, como las siguientes:
TransactionOption.Required SynchonizationOption.Disabled |
Muestra un error que describe el conflicto o modifica uno de los servicios en conflicto. |
Vea también
Registrar componentes con servicio Registrar un ensamblado dinámicamente | Herramienta Instalación de servicios de .NET Framework (Regsvcs.exe) | System.EnterpriseServicesRegistrationHelper | System.EnterpriseServices (Espacio de nombres)