Oggetto di database
L'oggetto Database accede a un database del programma di installazione.
L'oggetto Database viene rilasciato quando viene rimosso dall'ambito o quando la variabile oggetto associata è impostata su Null. Il metodo Commit deve essere chiamato prima che l'oggetto Database venga rilasciato per scrivere tutte le modifiche persistenti. Se il metodo Commit non viene chiamato, il programma di installazione esegue un rollback implicito alla distruzione dell'oggetto.
Il client può usare la procedura seguente per l'accesso ai dati.
Per eseguire query sul sequenziamento dell'API
- Ottenere un oggetto Database chiamando OpenDatabase o l'oggetto Installer .
- Avviare una query usando una stringa SQL chiamando il metodo OpenView dell'oggetto Database .
- Impostare i parametri di query in un oggetto Record ed eseguire la query di database chiamando il metodo Execute dell'oggetto View . Questo produce un risultato che può essere recuperato o aggiornato.
- Chiamare il metodo Fetch dell'oggetto View ripetutamente per restituire oggetti Record .
- Aggiornare le righe di database di un oggetto Record ottenuto dal metodo Fetch usando il metodo Modify dell'oggetto View .
- Rilasciare la query e tutti i record non recuperati chiamando il metodo Close dell'oggetto View .
- Rendere persistenti gli aggiornamenti del database chiamando il metodo Commit dell'oggetto Database .
Membri
L'oggetto Database include questi tipi di membri:
Metodi
L'oggetto Database include questi metodi.
| Metodo | Descrizione |
|---|---|
| ApplyTransform | Applica la trasformazione a questo database. |
| Commettere | Completa la forma persistente del database. |
| CreateTransformSummaryInfo | Crea e popola il flusso di informazioni di riepilogo di un file di trasformazione esistente. |
| EnableUIPreview | Semplifica la creazione di finestre di dialogo e tabelloni fornendo il supporto necessario per visualizzare le finestre di dialogo dell'interfaccia utente archiviate nel database del programma di installazione. |
| Esportazione | Copia la struttura e i dati da una tabella specificata in un file di archivio di testo. |
| GenerateTransform | Crea una trasformazione. |
| Importa | Importa una tabella di database da un file di archivio di testo. |
| Unione | Unisce il database di riferimento con il database di base. |
| Openview | Restituisce un oggetto View che rappresenta la query specificata da una stringa SQL. |
Proprietà
L'oggetto Database ha queste proprietà.
| Proprietà | Descrizione |
|---|---|
|
DatabaseState |
Restituisce lo stato di persistenza del database. |
|
PrimaryKeys |
Restituisce un oggetto Record contenente il nome della tabella e i nomi di colonna (che comprendono le chiavi primarie). |
|
SummaryInformation (oggetto database) |
Restituisce un oggetto SummaryInfo che può essere usato per esaminare, aggiornare e aggiungere proprietà al flusso di informazioni di riepilogo. |
|
TablePersistent |
Restituisce lo stato di persistenza della tabella. |
Requisiti
| Requisito | Valore |
|---|---|
| Versione |
Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP |
| DLL |
|
| IID |
IID_IDatabase è definito come 000C109D-0000-0000-C000-0000000000000046 |