Método Session.FormatRecord

El método FormatRecord del objeto Session devuelve una cadena con formato a partir de una plantilla y registra datos.

Sintaxis

Session.FormatRecord(
  record
)

Parámetros

record

Objeto Record requerido que contiene una plantilla y datos a los que se va a dar formato. La cadena de plantilla debe establecerse en el campo 0 seguido de los parámetros de datos a los que se hace referencia.

Valor devuelto

Este método no devuelve ningún valor.

Observaciones

El método FormatRecord usa el siguiente proceso de formato.

Los parámetros a los que se va a dar formato se incluyen entre corchetes . [ ] . Los corchetes se pueden iterar porque las sustituciones se resuelven desde dentro hacia fuera.

Si una parte de la cadena se incluye entre llaves { } y no contiene corchetes, la parte se deja sin modificar, incluidas las llaves.

Si una parte de la cadena está entre llaves y contiene uno o varios nombres de propiedad, y si se encuentran todas las propiedades, el texto (con las sustituciones resueltas) se muestra sin llaves. Si no se encuentra ninguna de las propiedades, se quita todo el texto de las llaves y las propias llaves.

Para dar formato a cadenas mediante el método FormatRecord

  1. Los parámetros numéricos se sustituyen reemplazando el marcador por el valor del campo de registro correspondiente, con valores nulos o ausentes que no producen texto.
  2. La cadena que da como resultado se procesa reemplazando los parámetros que no son de registro por los valores correspondientes, como se indica en las descripciones siguientes.
    • Si se encuentra una subcadena con el formato " [ propertyname ", se reemplaza por el valor de la propiedad ] .
    • Si se encuentra una subcadena con el formato [ "%environmentvariable", se sustituye el valor de ] la variable de entorno.
    • Si se encuentra una subcadena de la clave de archivo de formulario, se reemplaza por la ruta de acceso completa del archivo, por la clave de archivo de valor usada como clave en la [ # ] tabla File. El valor de filekey permanece en blanco y no se reemplaza por una ruta de acceso hasta que el instalador ejecuta la acción [ # ] CostInitialize, la acción FileCosty la 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 está ausente, la ruta de acceso está en blanco. Para obtener más información sobre cómo comprobar el estado de instalación de los componentes, vea Comprobar la instalación de características, componentes, archivos.
    • Si se encuentra una subcadena con el formato $componentkey, se reemplaza por el directorio de instalación del componente, por el valor [ ] componentkey usado como clave en la tabla Component. El valor de componentkey permanece en blanco y no se reemplaza por un directorio hasta que el instalador ejecuta la acción [ $ ] CostInitialize, la acción FileCosty la acción CostFinalize. El valor de [ $ componentkey ] depende del estado de instalación del componente. 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 está ausente, el valor se deja en blanco. Para obtener más información sobre cómo comprobar el estado de instalación de los componentes, vea Comprobar la instalación de características, componentes, archivos.
    • Si se encuentra una subcadena con el formato " c ", se reemplaza por [ \ el carácter sin ningún ] procesamiento adicional. Solo se conserva el primer carácter después de la barra diagonal inversa; se quita todo lo demás.

Requisitos

Requisito Value
Version
Windows Instalador 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Instalador 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Instalador en Windows Server 2003 o Windows XP
Archivo DLL
Msi.dll
IID
IID ISession se define como _ 000C109E-0000-0000-C000-00000000046

Consulte también

Formato

Tipos de datos de columna