Objet de base de données

  • Article

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

L’objet Database est libéré lorsqu’il est retiré de l’étendue ou lorsque la variable d’objet qui lui est associée a une valeur nulle. La méthode Commit doit être appelée avant que l’objet Database ne soit libéré 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 d’objets.

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

Pour demander le séquencement de l’API

  1. Obtenez un objet Database en appelant l’objet OpenDatabase ou Installer .
  2. Lancez une requête à l’aide d’une chaîne SQL en appelant la méthode OpenView de l’objet Database .
  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 Exécuter de l’objet Vue . Cela produit un résultat qui peut être extrait ou mis à jour.
  4. Appelez la méthode Fetch de l’objet Vue à 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 Modifier de l’objet Vue .
  6. Libérez la requête et tous les enregistrements non filtrés en appelant la méthode Fermer de l’objet Vue .
  7. Conservez toutes les mises à jour de base de données en appelant la méthode Commit de l’objet Database .

Membres

L’objet Record a les types de membres suivants :

Méthodes

L’objet Database possède ces méthodes.

Méthode Description
ApplyTransform Applique la transformation à cette base de données.
Engager Finalise la forme persistante de la base de données.
CreateTransformSummaryInfo Crée et remplit le flux d’informations récapitulatives d’un fichier de transformation existant.
EnableUIPreview Facilite la création de boîtes de dialogue et de panneaux d'affichage en fournissant le support nécessaire pour visualiser les boîtes de dialogue de l'interface utilisateur stockées dans la base de données de l'installateur.
Exporter Copie la structure et les données d’une table spécifiée dans un fichier d’archivage 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 Renvoie un objet Vue représentant la requête spécifiée par une chaîne SQL.

Propriétés

L’objet Database possède ces méthodes.

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 Database)
 Renvoie 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. 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

Exemples de scripts Windows Installer