Objeto de banco de dados
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
- Obtenha um objeto Database chamando o objeto OpenDatabase ou Installer.
- Inicie uma consulta usando uma cadeia de caracteres SQL chamando o método OpenView do objeto Database.
- 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.
- Chame o método Fetch do objeto View repetidamente para retornar objetos Record.
- Atualize as linhas de banco de dados de um objeto Record obtidas pelo método Fetch usando o método Modify do objeto View.
- Libere a consulta e todos os registros não buscados chamando o método Close do objeto View.
- 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 |
|
| IID |
O IID_IDatabase é definido como 000C109D-0000-0000-C000-000000000046 |