Objeto de base de datos

  • Artículo

El objeto Database tiene acceso a una base de datos del instalador.

El objeto Database se libera cuando se saca del ámbito o cuando la variable de objeto asociada se establece en null. Se debe llamar al método Commit antes de que se libere el objeto Database para escribir todos los cambios persistentes. Si no se llama al método Commit, el instalador realiza una reversión implícita tras la destrucción del objeto.

El cliente puede usar el siguiente procedimiento para acceder a los datos.

Para consultar la secuenciación de API

  1. Obtenga un objeto Database llamando a los objetos OpenDatabase o Installer.
  2. Inicie una consulta mediante una cadena SQL llamando al método OpenView del objeto Database.
  3. Establezca los parámetros de consulta en un objeto Record y ejecute la consulta de base de datos llamando al método Execute del objeto View. Esto genera un resultado que se puede capturar o actualizar.
  4. Llame al método Fetch del objeto View repetidamente para devolver objetos Record.
  5. Actualice las filas de base de datos de un objeto Record obtenido por el método Fetch mediante el método Modify del objeto View.
  6. Libere la consulta y los registros sin capturar llamando al método Close del objeto View.
  7. Conserve las actualizaciones de la base de datos llamando al método Commit del objeto Database.

Miembros

El objeto Database tiene estos tipos de miembros:

Métodos

El objeto Database tiene estos métodos.

Método Descripción
ApplyTransform Aplica la transformación a esta base de datos.
Commit Finaliza el formato persistente de la base de datos.
CreateTransformSummaryInfo Crea y rellena el flujo de información de resumen de un archivo de transformación existente.
EnableUIPreview Facilita la creación de controles Dialog box y Billboard proporcionando la compatibilidad necesaria para ver los cuadros de diálogo de la interfaz de usuario almacenados en la base de datos del instalador.
Exportación Copia la estructura y los datos de una tabla especificada en un archivo de texto.
GenerateTransform Crea una transformación.
Importar Importa una tabla de base de datos desde un archivo de texto.
Merge Combina la base de datos de referencia con la base de datos base.
OpenView Devuelve un objeto View que representa la consulta especificada por una cadena SQL.

Propiedades

El objeto Database tiene estas propiedades.

Propiedad Descripción
DatabaseState
 Devuelve el estado de persistencia de la base de datos.
PrimaryKeys
 Devuelve un objeto Record que contiene el nombre de la tabla y los nombres de columna (que constan de las claves principales).
SummaryInformation (objeto Database)
 Devuelve un objeto SummaryInfo que se puede usar para examinar, actualizar y agregar propiedades al flujo de información de resumen.
TablePersistent
 Devuelve el estado de persistencia de la tabla.

Requisitos

Requisito Value
Versión
 Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Archivo DLL
Msi.dll
IID
 IID_IDatabase se define como 000C109D-0000-0000-C000-000000000046

Consulte también

Ejemplos de scripting de Windows Installer