Objeto de banco de dados

  • Artigo

O objeto Database acessa um banco de dados do instalador.

O objeto Database é liberado quando é retirado do escopo ou quando a variável de objeto associada a ele é definida como nula. O método Commit deve ser chamado antes que o objeto Database seja liberado para gravar todas as alterações persistentes. Se o método Commit não for chamado, o instalador executará uma reversão implícita após a destruição do objeto.

O cliente pode usar o procedimento a seguir para acesso a dados.

Para consultar o sequenciamento de API

  1. Obtenha um objeto Database chamando o objeto OpenDatabase ou Installer.
  2. Inicie uma consulta usando uma cadeia de caracteres SQL chamando o método OpenView do objeto Database.
  3. Defina parâmetros de consulta em um objeto Record e execute a consulta de banco de dados chamando o método Execute do objeto View. Isso produz um resultado que pode ser buscado ou atualizado.
  4. Chame o método Fetch do objeto View repetidamente para retornar objetos Record.
  5. Atualize as linhas de banco de dados de um objeto Record obtidas pelo método Fetch usando o método Modify do objeto View.
  6. Libere a consulta e todos os registros não buscados chamando o método Close do objeto View.
  7. Persista todas as atualizações de banco de dados chamando o método Commit do objeto Database.

Membros

O objeto Database tem esses tipos de membros:

Métodos

O objeto Database tem esses métodos.

Método Descrição
ApplyTransform Aplica a transformação a esse banco de dados.
Commit Finaliza a forma persistente do banco de dados.
CreateTransformSummaryInfo Cria e preenche o fluxo de informações de resumo de um arquivo de transformação existente.
EnableUIPreview Facilita a criação de caixas de diálogo e outdoors fornecendo o suporte necessário para exibir as caixas de diálogo da interface do usuário armazenadas no banco de dados do instalador.
Exportação Copia a estrutura e os dados de uma tabela especificada para um arquivo de arquivo de texto.
GenerateTransform Cria uma transformação.
Importaçãoação Importa uma tabela de banco de dados de um arquivo morto de texto.
Merge Mescla o banco de dados de referência com o banco de dados base.
OpenView Retorna um objeto View que representa a consulta especificada por uma cadeia de caracteres SQL.

Propriedades

O objeto Database tem essas propriedades.

Propriedade Descrição
DatabaseState
 Retorna o estado de persistência do banco de dados.
PrimaryKeys
 Retorna um objeto Record que contém o nome da tabela e os nomes de coluna (compreendendo as chaves primárias).
SummaryInformation (Objeto de banco de dados)
 Retorna um objeto SummaryInfo que pode ser usado para examinar, atualizar e adicionar propriedades ao fluxo de informações de resumo.
TablePersistent
 Retorna o estado de persistência da tabela.

Requisitos

Requisito Valor
Versão
 Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
 O IID_IDatabase é definido como 000C109D-0000-0000-C000-000000000046

Confira também

Exemplos de scripts do Windows Installer