Méthode Database.ApplyTransform

Article
06/13/2023

La méthode ApplyTransform de l’objet Database applique la transformation à cette base de données.

Syntaxe

Database.ApplyTransform(
  storage,
  errorConditions
)

Paramètres

storage

Chemin d’accès au fichier de transformation appliqué. Ce paramètre est obligatoire.

errorConditions

Spécifie les conditions d’erreur qui doivent être supprimées. Spécifiez comme combinaison des valeurs entières suivantes.

État d’erreur	Signification
msiTransformErrorAddExistingRow 0x0001	Ajoute une ligne déjà existante.
msiTransformErrorDeleteNonExistingRow 0x0002	Supprime une ligne inexistante.
msiTransformErrorAddExistingTable 0x0004	Ajoute une table déjà existante.
msiTransformErrorDeleteNonExistingTable 0x0008	Supprime une table inexistante.
msiTransformErrorUpdateNonExistingRow 0x0010	Met à jour une ligne inexistante.
msiTransformErrorChangeCodePage 0x0020	Les pages de code de transformation et de base de données ne correspondent pas et aucune n’a de page de code neutre.
msiTransformErrorViewTransform 0x0100	Crée la table _TransformView temporaire.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

La méthode ApplyTransform retarde la transformation des tables jusqu’au dernier moment possible. Les étapes effectuées dans ApplyTransform consistent à transformer immédiatement les catalogues de tables et de colonnes pour la base de données. Les catalogues de tables et de colonnes sont mis à jour en fonction de la table ajoutée ou supprimée et de la colonne ajoutée (aucune suppression de colonnes n’est autorisée). Si une table est actuellement chargée en mémoire et doit être transformée, elle est transformée. Sinon, l’état de la table est défini sur celui nécessitant une transformation, de sorte que lorsque la table est chargée ou lorsque la base de données est validée, la transformation est appliquée. La transformation dans cette instance signifie que les données réelles (ligne) de la table sont ajoutées, supprimées ou mises à jour.

Si la méthode échoue, vous pouvez obtenir des informations d’erreur détaillées à l’aide de la méthode LastErrorRecord.

Configuration requise

Condition requise	Valeur
Version	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
DLL	Msi.dll
IID	IID_IDatabase est défini comme 000C109D-0000-0000-C000-000000000046

Voir aussi

Base de données
Transformations de base de données

Partager via