Objet de base de données
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
- Obtenez un objet Database en appelant l’objet OpenDatabase ou Installer .
- Lancez une requête à l’aide d’une chaîne SQL en appelant la méthode OpenView de l’objet Database .
- 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.
- Appelez la méthode Fetch de l’objet Vue à plusieurs reprises pour renvoyer des objets Record .
- 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 .
- Libérez la requête et tous les enregistrements non filtrés en appelant la méthode Fermer de l’objet Vue .
- 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 |
|
| IID |
IID_IDatabase est défini comme 000C109D-0000-0000-C000-000000000046 |