Share via


CustomActionData (Propiedad)

Especifica datos adicionales que se pueden evaluar con una acción personalizada durante la instalación. Las acciones personalizadas se ejecutan al final de una instalación y no pueden tener acceso a información sobre la instalación; la propiedad CustomActionData para cada acción personalizada permite almacenar información sobre la instalación que pueda leerse con la acción personalizada.

Por ejemplo, si un proyecto de implementación incluía una búsqueda de archivos con una propiedad Property de FILESEARCH1, se podría pasar el valor devuelto por la búsqueda de archivos definiendo la propiedad CustomActionData en /MyFile=[FILESEARCH1]. En la acción personalizada, se podría realizar una consulta de la propiedad MyFile para recuperar el valor.

Comentarios

El formato de la propiedad CustomActionData dependerá del tipo de acción personalizada.

  • En las acciones personalizadas que son componentes de instalación (clases ProjectInstaller), la propiedad CustomActionData toma un formato de /name=value. Cada nombre debe ser único y tener sólo un valor. Los valores múltiples deben separarse con un espacio simple: /namee1=value1 /name2=value2. Si el valor incluye un espacio, se debe entrecomillar: /name="a value".

    Las propiedades de Windows Installer se pueden pasar utilizando sintaxis con corchetes: /name=[PROPERTYNAME]. En propiedades de Windows Installer como [TARGETDIR], que devuelven un directorio, además de los corchetes, se deben incluir comillas y una barra inversa al final: /name="[TARGETDIR]\".

    Nota

    Para que una acción personalizada se trate como un componente de instalación, la propiedad InstallerClass se debe definir como true. Para obtener más información, vea RunInstallerAttribute.

  • Para las demás acciones personalizadas (.exe, .dll o script), no hay requisitos de formato. Puede pasar cualquier cadena en la propiedad CustomActionData, puesto que debe analizar la en la acción personalizada.

Solución de problemas

Si su acción personalizada espera que los clientes escriban una ruta de acceso a una carpeta de instalación, puede ver un mensaje de error ArgumentException. Esto puede estar relacionado con un directorio o dirección URL no válidos.

Para evitar este mensaje de error, reemplace la barra diagonal inversa con un espacio: /name="[TARGETDIR] ". Después, analice el valor y cree una ruta de acceso completa mediante el método Combine.

Vea también

Tareas

Tutorial: Utilizar una acción personalizada para mostrar un mensaje durante la instalación

Referencia

Propiedades del Editor de acciones personalizadas

InstallerClass (Propiedad)