Objet de base de données

L’objet de base de données accède à une base de données du programme d’installation.

L’objet de base de données est libéré lorsqu’il est retiré de l’étendue ou lorsque la variable objet associée est définie sur null. La méthode de validation doit être appelée avant que l’objet de base de données ne soit libéré pour écrire toutes les modifications persistantes. Si la méthode de validation n’est pas appelée, le programme d’installation effectue une restauration implicite lors de la destruction de l’objet.

Le client peut utiliser la procédure suivante pour l’accès aux données.

Pour interroger l’API de séquencement

  1. Obtenez un objet de base de données en appelant l’objet OpenDatabase ou le programme d’installation .
  2. lancez une requête à l’aide d’une chaîne de SQL en appelant la méthode OpenView de l’objet de base de données .
  3. Définissez les paramètres de requête dans un objet enregistrement et exécutez la requête de base de données en appelant la méthode Execute de l’objet View . Cela génère un résultat qui peut être extrait ou mis à jour.
  4. Appelez la méthode Fetch de l’objet View à plusieurs reprises pour retourner des objets Record .
  5. Met à jour les lignes de base de données d’un objet Record obtenu par la méthode Fetch à l’aide de la méthode Modify de l’objet View .
  6. Libérez la requête et tous les enregistrements non récupérés en appelant la méthode Close de l’objet View .
  7. Conservez toutes les mises à jour de base de données en appelant la méthode Commit de l’objet Database .

Membres

L’objet de base de données a les types de membres suivants :

Méthodes

L’objet de base de données a ces méthodes.

Méthode Description
ApplyTransform Applique la transformation à cette base de données.
Commit Finalise la forme persistante de la base de données.
CreateTransformSummaryInfo Crée et remplit le flux d’informations de synthèse d’un fichier de transformation existant.
EnableUIPreview Facilite la création de boîtes de dialogue et de panneaux en fournissant la prise en charge nécessaire pour afficher les boîtes de dialogue de l’interface utilisateur stockées dans la base de données du programme d’installation.
Exporter Copie la structure et les données d’une table spécifiée dans un fichier d’archive de texte.
GenerateTransform Crée une transformation.
Importer Importe une table de base de données à partir d’un fichier d’archive de texte.
Fusion Fusionne la base de données de référence avec la base de données de base.
OpenView retourne un objet de vue représentant la requête spécifiée par une chaîne de SQL.

Propriétés

L’objet de base de données a ces propriétés.

Propriété Description
DatabaseState
Retourne l’état de persistance de la base de données.
PrimaryKeys
Retourne un objet Record contenant le nom de la table et les noms des colonnes (qui composent les clés primaires).
SummaryInformation (objet de base de données)
Retourne un objet SummaryInfo qui peut être utilisé pour examiner, mettre à jour et ajouter des propriétés au flux d’informations de synthèse.
TablePersistent
Retourne l’état de persistance de la table.

Spécifications

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 en tant que 000C109D-0000-0000-C000-000000000046

Voir aussi

Windows Exemples de scripts d’installation