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 transformationsdatei, die angewendet wird. Dieser Parameter ist erforderlich.

errorConditions

Gibt die Fehlerbedingungen an, die unterdrückt werden sollen. Geben Sie als 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 Datenbankcodeseiten stimmen nicht überein und beide haben keine neutrale Codepage.
msiTransformErrorViewTransform
0x0100
Erstellt die temporäre _ TransformView-Tabelle.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die ApplyTransform-Methode verzögert die Transformation von Tabellen bis zum letzten möglichen Zeitpunkt. In ApplyTransform werden die Tabellen- und Spaltenkataloge für die Datenbank sofort transformiert. Die Tabellen- und Spaltenkataloge werden entsprechend der hinzugefügten oder gelöschten Tabelle und der hinzugefügten Spalte aktualisiert (das Löschen von Spalten ist nicht zulässig). Wenn eine Tabelle derzeit in den Arbeitsspeicher geladen wird und transformiert werden muss, wird sie transformiert. Andernfalls wird der Tabellenzustand auf festgelegt, der eine Transformation erfordert, sodass beim Laden der Tabelle oder beim Commit der Datenbank die Transformation angewendet wird. Transformieren in dieser Instanz bedeutet, dass die tatsächlichen (Zeilen-)Daten der Tabelle hinzugefügt, gelöscht oder aktualisiert werden.

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

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Installationsprogramm 5.0 auf Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 auf Windows Server 2008 oder Windows Vista. Windows Installationsprogramm auf Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
IID _ IDatabase ist als 000C109D-0000-0000-C000-000000000046 definiert.

Weitere Informationen

Datenbank

Datenbanktransformationen