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 |
|
| IID |
IID _ IDatabase ist als 000C109D-0000-0000-C000-000000000046 definiert. |