Share via


Cómo: Reemplazar métodos predeterminados en componentes de instalación

Actualización: noviembre 2007

De manera predeterminada, cada componente de instalación tiene los métodos siguientes:

  • Install: todas las funciones de instalación que debe ejecutar el instalador se realizan en este método. La clase Installer1 (o cualquier clase con el valor RunInstallerAttribute establecido en true) llama a Install en cada componente de instalación que contiene y, a continuación, llama a Commit (si todas las instalaciones son correctas) o a Rollback (si se han producido errores).

  • Commit: una vez que el método Commit se ha ejecutado correctamente en todos los componentes de instalación que contiene la clase del instalador, se llama a Install. En este momento se confirman todas las instalaciones. Normalmente, no se realiza ningún procesamiento en el método Commit para evitar que se produzcan excepciones.

  • Rollback: el método Rollback se utiliza para deshacer todo el trabajo de instalación previo si se produce un error en cualquier punto del proceso de instalación. Si uno de los componentes de instalación que contiene la clase del instalador produce un error, se deshacen todas las instalaciones realizadas hasta el momento.

  • Uninstall: Uninstall se utiliza para quitar recursos del componente de instalación del sistema. A diferencia de la instalación, la desinstalación no es transaccional. Si falla un proceso de desinstalación, el sistema intentará desinstalar el resto de recursos.

Cada uno de estos métodos contiene un proceso predeterminado que realizará el trabajo requerido sin modificación. No obstante, si lo desea puede reemplazar y modificar el proceso en cada paso. Por ejemplo, es posible que, en un componente de instalación ServiceBase, desee modificar el proceso predeterminado que se produce en el procedimiento Commit para que el proceso de instalación inicie el servicio una vez que se ha instalado correctamente. También podría modificar el procedimiento Uninstall para detener cada servicio antes de desinstalarlo.

Para reemplazar los métodos predeterminados en un componente de instalación

  1. Después de agregar un componente de instalación a la solución, abra la clase del instalador.

  2. Localice el componente de instalación que desea modificar y obtenga acceso al mismo en el Editor de código.

  3. Reemplace el método correspondiente y agregue la funcionalidad que desee. Para obtener más información, vea Invalidar propiedades y métodos.

    Sugerencia:

    Asegúrese de que conserva el proceso original necesario para instalar, confirmar, deshacer o desinstalar los recursos cuando reemplace métodos en la clase Installer1. En general, debería agregar código a las funciones existentes después de quitar la funcionalidad existente.

Vea también

Tareas

Cómo: Agregar componentes de instalación a los proyectos

Cómo: Configurar componentes para la instalación

Tutorial: Instalar un componente de registro de eventos

Conceptos

Invalidar propiedades y métodos