Objet de base de données

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

L’objet Base de données est libéré lorsqu’il est retiré de l’étendue ou lorsque la variable d’objet associée à celle-ci est définie sur null. La méthode Commit doit être appelée avant la publication de l’objet Database pour écrire toutes les modifications persistantes. Si la méthode Commit 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 le séquencement d’API

  1. Obtenez un objet Database en appelant OpenDatabase ou l’objet Installer .
  2. Lancez une requête à l’aide d’une chaîne SQL en appelant la méthode OpenView de l’objet Base de données.
  3. Définissez les paramètres de requête dans un objet Record et exécutez la requête de base de données en appelant la méthode Execute de l’objet View . Cela produit un résultat qui peut être extrait ou mis à jour.
  4. Appelez la méthode Fetch de l’objet View à plusieurs reprises pour renvoyer des objets Record .
  5. Mettez à 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. Relâchez la requête et tous les enregistrements non bloqué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 Base de données comporte ces types de membres :

Méthodes

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

Méthode Description
ApplyTransform Applique la transformation à cette base de données.
Commettre Finalise la forme persistante de la base de données.
CreateTransformSummaryInfo Crée et remplit le flux d’informations récapitulative d’un fichier de transformation existant.
EnableUIPreview Facilite la création des boîtes de dialogue et des panneaux d’affichage en fournissant la prise en charge nécessaire pour afficher les boîtes de dialogue d’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 texte.
GenerateTransform Crée une transformation.
Importer Importe une table de base de données à partir d’un fichier d’archive texte.
Fusionner Fusionne la base de données de référence avec la base de données de base.
Openview Retourne un objet View représentant la requête spécifiée par une chaîne SQL.

Propriétés

L’objet Base de données possède ces propriétés.

Propriété Description
DatabaseState
Retourne l’état de persistance de la base de données.
PrimaryKeys
Renvoie un objet Record contenant le nom de la table et les noms de colonnes (comprenant 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 récapitulatives.
TablePersistent
Retourne l’état de persistance de la table.

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. programme d’installation Windows sur Windows Server 2003 ou Windows XP
DLL
Msi.dll
IID
IID_IDatabase est défini comme 000C109D-0000-0000-C000-000000000046

Voir aussi

Windows Exemples de script de programme d’installation