Database.ApplyTransform-Methode

  • Artikel

Die ApplyTransform-Methode des Database-Objekts wendet die Transformation auf diese Datenbank an.

Syntax

Database.ApplyTransform(
  storage,
  errorConditions
)

Parameter

storage

Pfad zur angewendeten Transformationsdatei. Dieser Parameter ist erforderlich.

errorConditions

Gibt die Fehlerbedingungen an, die unterdrückt werden sollen. Geben Sie eine Kombination der folgenden ganzzahligen Werte an.

Fehlerzustand Bedeutung
msiTransformErrorAddExistingRow
0x0001
 Fügt eine Zeile hinzu, die bereits vorhanden ist.
msiTransformErrorDeleteNonExistingRow
0x0002
 Löscht eine Zeile, die nicht vorhanden ist.
msiTransformErrorAddExistingTable
0x0004
 Fügt eine Tabelle hinzu, die bereits vorhanden ist.
msiTransformErrorDeleteNonExistingTable
0x0008
 Löscht eine Tabelle, die nicht vorhanden ist.
msiTransformErrorUpdateNonExistingRow
0x0010
 Aktualisiert eine Zeile, die nicht vorhanden ist.
msiTransformErrorChangeCodePage
0x0020
 Transformations- und Datenbankcodepages stimmen nicht überein, und weder Datenbank noch Transformation weisen eine neutrale Codepage auf.
msiTransformErrorViewTransform
0x0100
 Erstellt die temporäre _TransformView-Tabelle.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die ApplyTransform-Methode verzögert das Transformieren von Tabellen bis zum letztmöglichen Moment. Mit den in ApplyTransform ausgeführten Schritten werden die Tabellen- und Spaltenkataloge für die Datenbank sofort transformiert. Die Tabellen- und Spaltenkataloge werden aktualisiert, je nachdem, welche Tabelle hinzugefügt oder gelöscht wird und welche Spalte hinzugefügt wird (das Löschen von Spalten ist nicht zulässig). Wenn eine Tabelle derzeit im Arbeitsspeicher geladen ist und transformiert werden muss, wird sie transformiert. Andernfalls wird der Tabellenzustand auf den Zustand festgelegt, der eine Transformation erfordert, sodass die Transformation beim Laden der Tabelle oder Committen der Datenbank angewendet wird. Transformation bedeutet in diesem Fall, dass die tatsächlichen Daten (Zeilendaten) der Tabelle hinzugefügt, gelöscht oder aktualisiert werden.

Wenn die Methode fehlschlägt, können Sie mit der LastErrorRecord-Methode erweiterte Fehlerinformationen abrufen.

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

Datenbank

Datenbanktransformationen