Formato

El tipo de datos con formato es una cadena de texto que se procesa para resolver nombres de propiedad incrustados, claves de tabla, referencias de variables de entorno y otras subcadenas especiales. Se reconocen las siguientes convenciones para resolver la cadena:

• Los corchetes ([ ]) o llaves ({ }) sin par coincidente quedan en el texto.

• Si se encuentra una subcadena del formulario [propertyname] , se reemplaza por el valor de la propiedad . Si propertyname no es un nombre de propiedad válido, la subcadena se resuelve como en blanco. Por ejemplo, la columna Descripción de Tabla LaunchCondition toma una cadena con formato. Si ERRORTXT se ha establecido en "Póngase en contacto con el personal de soporte técnico". A continuación, el texto que se muestra para que se produzca un error en la condición de inicio incluirá esta cadena. Si ERRORTXT no está establecido, el texto mostrado para producir un error en la condición de inicio sería simplemente "El sistema no cumple los requisitos de instalación".

  Condición	Descripción
  Version9X	El sistema no cumple los requisitos de instalación. [ERRORTXT]

   

• Los corchetes se pueden iterar y los nombres de propiedad se resuelven desde dentro de fuera. Por ejemplo, suponga que la subcadena [[PropertyA]] aparece en el texto. En primer lugar, se recupera el valor de la propiedad PropertyA. Si el valor es un nombre de propiedad válido, como PropertyB, se recupera el valor de PropertyB y se sustituye toda la subcadena [[PropertyA]] por el valor propertyB. Si PropertyA no es un nombre de propiedad válido o si el valor de PropertyA no es un nombre de propiedad válido, la subcadena está en blanco.

• Si se encuentra una subcadena del formulario [%environmentvariable] , el valor de la variable de entorno se sustituye por la subcadena.

• Si se encuentra una subcadena del formulario [\x] , se reemplaza por el carácter x , donde x es un carácter, sin ningún procesamiento adicional. Solo se mantiene el primer carácter después de la barra diagonal inversa; todo lo demás se quita. Por ejemplo, para incluir un corchete izquierdo literal ([), use [\[]. El texto [\[]Bracket Text[\]] se resuelve en [Texto entre corchetes].

• Si una subcadena se incluye entre llaves ({ }) y no contiene nombres de propiedad entre corchetes ([ ]), la subcadena se deja sin cambios, incluidas las llaves.

• Si una subcadena se incluye entre llaves ({ }) y contiene uno o más nombres de propiedad entre corchetes ([ ]), si todos los nombres de propiedad son válidos, se muestra el texto (con las sustituciones resueltas) sin las llaves.

• Si se encuentra una subcadena del formulario [~], se reemplaza por el carácter NULL. Se usa para crear cadenas de caracteres REG_MULTI_SZ en la tabla del Registro de . Tenga en cuenta que [~] también se usa para anexar o prefijo valores a variables de entorno mediante la tabla entorno de .

• Si se encuentra una subcadena del formulario [#filekey] , se reemplaza por la ruta de acceso completa del archivo, por el valor clave de archivo que se usa como clave en la tabla archivo . El valor de [#filekey] permanece en blanco y no se reemplaza por una ruta de acceso hasta que el instalador ejecute la acción CostInitialize, acción FileCosty acción CostFinalize. El valor de [#filekey] depende del estado de instalación del componente al que pertenece el archivo. Si el componente se ejecuta desde el origen, el valor es la ruta de acceso a la ubicación de origen del archivo. Si el componente se ejecuta localmente, el valor es la ruta de acceso a la ubicación de destino del archivo después de la instalación. Si el componente tiene un estado de acción ausente, el estado instalado del componente se usa para determinar el [).

• Si se encuentra una subcadena del formulario [$componentkey] , se reemplaza por el directorio de instalación del componente, por el valor componentkey usado como clave en la tabla componente . El valor de [$componentkey] permanece en blanco y no se reemplaza por un directorio hasta que el instalador ejecute la acción CostInitialize, acción FileCosty acción CostFinalize. El valor de [$componentkey] depende del estado de instalación del componente y de dónde se produzca. En la columna Valor de la Tabla del Registro, esta subcadena puede hacer referencia al estado de acción o al estado de acción solicitado del componente. En todos los demás casos, esta subcadena hace referencia al estado de acción del componente. Por ejemplo, si el componente se ejecuta desde el origen, el valor es el directorio de origen del archivo. Si el componente se ejecuta localmente, el valor es el directorio de destino después de la instalación. Si el componente no está presente, el valor se deja en blanco. Windows Installer realiza un seguimiento de la acción y los estados de instalación solicitados de los componentes. Por ejemplo, si un componente ya está instalado, puede tener un estado solicitado de local y un estado de acción null. Para obtener más información sobre cómo comprobar el estado de instalación de los componentes, vea Comprobación de la instalación de características, componentes, archivos.

• Tenga en cuenta que si un componente ya está instalado y no se vuelve a instalar, quita o mueve durante la instalación actual, el estado de acción del componente es NULL y la cadena [$componentkey] se evalúa como Null.

• Si se encuentra una subcadena del formulario [!filekey] , se reemplaza por la ruta de acceso corta completa del archivo, por el valor clave de archivo que se usa como clave en la tabla archivo .

  Esta sintaxis solo es válida cuando se usa en la columna Valor de las tablas Registry o IniFile. Cuando se usa en otras columnas, esta sintaxis se trata igual que [#filekey] .