Datenbankobjekt
Das Database-Objekt greift auf eine Installationsdatenbank zu.
Das Database-Objekt wird freigegeben, wenn es aus dem Gültigkeitsbereich entfernt oder die zugeordnete Objektvariable auf NULL festgelegt wird. Die Commit-Methode muss vor der Freigabe des Database-Objekts aufgerufen werden, damit alle persistenten Änderungen geschrieben werden. Wenn die Commit-Methode nicht aufgerufen wird, führt der Installer bei der Objektzerstörung ein implizites Rollback durch.
Der Client kann das folgende Verfahren für den Datenzugriff verwenden.
So fragen Sie die API-Sequenzierung ab
- Rufen Sie ein Database-Objekt ab, indem Sie das OpenDatabase- oder das Installer-Objekt aufrufen.
- Initiieren Sie eine Abfrage mithilfe einer SQL-Zeichenfolge, indem Sie die OpenView-Methode des Database-Objekts aufrufen.
- Legen Sie Abfrageparameter in einem Record-Objekt fest, und führen Sie die Datenbankabfrage aus, indem Sie die Execute-Methode des View-Objekts aufrufen. Dadurch wird ein Ergebnis erzeugt, das abgerufen oder aktualisiert werden kann.
- Rufen Sie wiederholt die Fetch-Methode des View-Objekts auf, um Record-Objekte zurückzugeben.
- Aktualisieren Sie Datenbankzeilen eines Record-Objekts, das von der Fetch-Methode abgerufen wurde, indem Sie die Modify-Methode des View-Objekts verwenden.
- Geben Sie die Abfrage und alle nicht abgerufenen Datensätze frei, indem Sie die Close-Methode des View-Objekts aufrufen.
- Speichern Sie alle Datenbankupdates dauerhaft, indem Sie die Commit-Methode des Database-Objekts aufrufen.
Member
Das Database-Objekt weist die folgenden Membertypen auf:
Methoden
Das Database-Objekt verfügt über folgende Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| ApplyTransform | Wendet die Transformation auf diese Datenbank an. |
| Commit | Finalisiert die persistente Form der Datenbank. |
| CreateTransformSummaryInfo | Erstellt den Datenstrom mit zusammenfassenden Informationen einer vorhandenen Transformationsdatei und füllt ihn auf. |
| EnableUIPreview | Erleichtert die Erstellung von Dialogfeldern und Billboards, indem die Unterstützung bereitgestellt wird, die zum Anzeigen der in der Installationsdatenbank gespeicherten Dialogfelder der Benutzeroberfläche erforderlich ist. |
| Exportieren | Kopiert die Struktur und die Daten aus einer angegebenen Tabelle in eine Textarchivdatei. |
| GenerateTransform | Erstellt eine Transformation. |
| Importieren | Importiert eine Datenbanktabelle aus einer Textarchivdatei. |
| Merge | Führt die Referenzdatenbank mit der Basisdatenbank zusammen. |
| OpenView | Gibt ein View-Objekt zurück, das die von einer SQL-Zeichenfolge angegebene Abfrage darstellt. |
Eigenschaften
Das Database-Objekt verfügt über folgende Eigenschaften.
| Eigenschaft | BESCHREIBUNG |
|---|---|
|
DatabaseState |
Gibt den Persistenzzustand der Datenbank zurück. |
|
PrimaryKeys |
Gibt ein Record-Objekt zurück, das den Tabellennamen und die Spaltennamen (mit den Primärschlüsseln) enthält. |
|
SummaryInformation (Database-Objekt) |
Gibt ein SummaryInfo-Objekt zurück, das zum Untersuchen und Aktualisieren sowie zum Hinzufügen von Eigenschaften zum Datenstrom mit zusammenfassenden Informationen verwendet werden kann. |
|
TablePersistent |
Gibt den Persistenzzustand der Tabelle zurück. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Version |
Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP |
| DLL |
|
| IID |
IID_IDatabase ist definiert als 000C109D-0000-0000-C000-000000000046 |