Datenbankobjekt

  • Artikel

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

  1. Rufen Sie ein Database-Objekt ab, indem Sie das OpenDatabase- oder das Installer-Objekt aufrufen.
  2. Initiieren Sie eine Abfrage mithilfe einer SQL-Zeichenfolge, indem Sie die OpenView-Methode des Database-Objekts aufrufen.
  3. 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.
  4. Rufen Sie wiederholt die Fetch-Methode des View-Objekts auf, um Record-Objekte zurückzugeben.
  5. Aktualisieren Sie Datenbankzeilen eines Record-Objekts, das von der Fetch-Methode abgerufen wurde, indem Sie die Modify-Methode des View-Objekts verwenden.
  6. Geben Sie die Abfrage und alle nicht abgerufenen Datensätze frei, indem Sie die Close-Methode des View-Objekts aufrufen.
  7. 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
Msi.dll
IID
 IID_IDatabase ist definiert als 000C109D-0000-0000-C000-000000000046

Siehe auch

Windows Installer-Skriptbeispiele