Condividi tramite


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

  1. Ottenere un oggetto Database chiamando OpenDatabase o l'oggetto Installer .
  2. Avviare una query usando una stringa SQL chiamando il metodo OpenView dell'oggetto Database .
  3. 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.
  4. Chiamare il metodo Fetch dell'oggetto View ripetutamente per restituire oggetti Record .
  5. Aggiornare le righe di database di un oggetto Record ottenuto dal metodo Fetch usando il metodo Modify dell'oggetto View .
  6. Rilasciare la query e tutti i record non recuperati chiamando il metodo Close dell'oggetto View .
  7. 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
Msi.dll
IID
IID_IDatabase è definito come 000C109D-0000-0000-C000-0000000000000046

Vedi anche

Esempi di scripting di Windows Installer