Compartir a través de

Tutorial: Crear una acción personalizada

  • Artículo

Actualización: noviembre 2007

En el tutorial siguiente se muestra el proceso de crear una acción personalizada en una DLL para dirigir a un usuario a una página Web al final de una instalación.

Nota:

Los cuadros de diálogo y los comandos de menú que se ven pueden diferir de los descritos en la Ayuda, dependiendo de los valores de configuración o de edición activos. Para cambiar su configuración, haga clic en Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.
Nota:

En las siguientes instrucciones se utiliza un proyecto Visual Basic como un ejemplo para mostrar cómo crear una implementación. Los principios generales se aplican a todos los proyectos de lenguajes de Visual Studio que admiten la implementación de aplicaciones basadas en Windows.

Para crear la acción personalizada

  1. En el menú Archivo, haga clic en Nuevo proyecto.

  2. En el cuadro de diálogo Nuevo proyecto, seleccione Proyectos de Visual Basic en el panel Tipos de proyecto y, a continuación, haga clic en Biblioteca de clases en el panel Plantillas. En el cuadro Nombre, escriba OpenWeb.

    El proyecto se agregará al Explorador de soluciones.

  3. En el menú Proyecto, haga clic en Agregar clase y, a continuación, en el cuadro de diálogo Agregar nuevo elemento, seleccione Clase del instalador. Acepte el nombre predeterminado de Installer1.vb. Haga clic en Agregar.

  4. Cambie a la vista Código haciendo clic en haga clic aquí para cambiar a la vista Código en la superficie de diseño (o haciendo clic con el botón secundario en la superficie de diseño y haciendo clic en Ver código).

  5. En el Editor de código, agregue el código siguiente (que abre un explorador web) a Installer1.vb, debajo del constructor:

    <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> _
Public Overrides Sub Commit(ByVal savedState As _
  System.Collections.IDictionary)

  MyBase.Commit(savedState)
  System.Diagnostics.Process.Start("https://www.microsoft.com")
End Sub
    Nota:

    Si escribe Public Overrides y luego deja un espacio, IntelliSense mostrará una lista de métodos y propiedades; puede seleccionar Commit en la lista y obtener la declaración completa.

  6. En el Explorador de soluciones, haga clic con el botón secundario en Class1.vb y, a continuación, seleccione Eliminar (dado que es innecesario).

Para agregar un proyecto de implementación

  1. En el menú Archivo, elija Agregar y, después, haga clic en Nuevo proyecto.

  2. En el panel Tipo de proyecto del cuadro de diálogo Agregar nuevo proyecto, abra el nodo Otros tipos de proyectos y, a continuación, seleccione Proyectos de instalación e implementación. En el panel Plantillas, haga clic en Proyecto de instalación. En el cuadro Nombre, escriba Instalador de acción personalizada.

    El proyecto se agregará al Explorador de soluciones y se mostrará el Editor del sistema de archivos.

  3. En el Editor del sistema de archivos, seleccione Carpeta de la aplicación en el panel izquierdo. En el menú Acción, elija Agregar y, a continuación, haga clic en Resultados del proyecto.

  4. En el cuadro de diálogo Agregar grupo de resultados del proyecto, OpenWeb se mostrará en la lista Proyecto. Seleccione Resultado principal.

    En Carpeta de la aplicación aparece Resultado principal desde OpenWeb (Activo).

Para agregar la acción personalizada

  1. Seleccione el proyecto Instalador de acción personalizada en el Explorador de soluciones. En el menú Ver, elija Editor y, a continuación, haga clic en Acciones personalizadas.

    Se abre el Editor de acciones personalizadas.

  2. En el Editor de acciones personalizadas, seleccione el nodo Commit. En el menú Acción, haga clic en Agregar acción personalizada.

  3. En el cuadro de diálogo Seleccionar elemento en el proyecto, haga doble clic en Carpeta de la aplicación. Seleccione Resultado principal desde OpenWeb.

    Resultado principal desde OpenWeb aparece bajo el nodo Commit en el Editor de acciones personalizadas.

  4. En la ventana Propiedades, asegúrese de que la propiedad InstallerClass está establecida en True (éste es el valor predeterminado).

  5. En el Editor de acciones personalizadas, seleccione el nodo Install y agregue Resultado principal desde OpenWeb a este nodo, tal como hizo para el nodo Commit.

  6. En el menú Generar, haga clic en Generar Instalador de acción personalizada.

Para instalar en el equipo de desarrollo

  • Seleccione el proyecto Instalador de acción personalizada en el Explorador de soluciones. En el menú Proyecto, haga clic en Instalar.

    Esto hará que se ejecute el instalador y se instale el Instalador de acción personalizada en el equipo de desarrollo. Al final de la instalación, se iniciará Internet Explorer y se abrirá el sitio web Microsoft.com.

    Nota:

    Debe tener permisos de instalación en el equipo para poder ejecutar el instalador.

Para implementar en otro equipo

  1. En el Explorador de Windows, navegue hasta el directorio del proyecto y busque el instalador que se ha generado. La ruta de acceso predeterminada será \Documents and Settings\sunombreusuario\Mis documentos\Visual Studio\Projects\Custom Action Installer\Custom Action Installer\project configuration\Custom Action Installer.msi. La configuración del proyecto predeterminada es Depurar.

  2. Copie el archivo Instalador de acción personalizada.msi, Setup.exe, y todos los demás archivos y subdirectorios del directorio en el otro equipo.

    Nota:

    Para realizar una instalación en un equipo que no esté en red, copie los archivos en un soporte tradicional, como un CD-ROM.

  3. En el equipo de destino, haga doble clic en el archivo Setup.exe para ejecutar el instalador.

    Al final de la instalación, se iniciará Internet Explorer y se abrirá el sitio Web Microsoft.com.

    Nota:

    Debe tener permisos de instalación en el equipo para poder ejecutar el instalador.
    Nota:

    Si .NET Framework no está todavía instalado en el equipo de destino, esta implementación lo instalará y es posible que tarde varios minutos.

Para desinstalar la aplicación

  1. En el Panel de control, haga doble clic en Agregar o quitar programas.

  2. En el cuadro de diálogo Agregar o quitar programas, seleccione Instalador de acción personalizada y haga clic en Quitar.

    Sugerencia:

    Para desinstalar un programa de su equipo de desarrollo, con el proyecto Instalador de acción personalizada abierto y seleccionado en el Explorador de soluciones, haga clic en Desinstalar, en el menú Proyecto.

Vea también

Conceptos

Acciones personalizadas

Otros recursos

Administración de acciones personalizadas en la implementación