Freigeben über


Database.ApplyTransform-Methode

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