Source de données : gestion des connexions (ODBC)

Article
06/10/2015

Cette rubrique s'applique aux classes ODBC MFC.

Cette rubrique explique :

Comment configurer une source de données
Comment un environnement multi-utilisateur affecte une source de données et ses recordsets
Pourquoi généraliser une chaîne de connexion à une source de données
Comment se connecter à une source de données
Comment se déconnecter d'une source de données
Comment réutiliser un objet CDatabase

La connexion à une source de données signifie l'établissement de communications avec un système de gestion de base de données (SGBD) pour accéder aux données. Lorsque vous vous connectez à une source de données à partir d'une application par le biais d'un pilote ODBC, le pilote établit la connexion pour vous, localement ou via un réseau.

Vous pouvez vous connecter à toute source de données pour laquelle vous possédez un pilote ODBC. Les utilisateurs de votre application doivent également disposer du même pilote ODBC pour leur source de données. Pour plus d'informations sur la redistribution de pilotes ODBC, consultez Redistribution des composants ODBC à vos clients.

Configuration d'une source de données

L'Administrateur ODBC est utilisé pour configurer vos sources de données. Vous pouvez également utiliser l'Administrateur ODBC après l'installation pour ajouter ou supprimer des sources de données. Lorsque vous créez des applications, vous pouvez diriger vos utilisateurs vers l'Administrateur ODBC pour leur permettre d'ajouter des sources de données, ou créer cette fonctionnalité dans votre application en effectuant des appels d'installation ODBC directs. Pour plus d'informations, consultez Administrateur ODBC.

Vous pouvez utiliser un fichier Excel comme source de données que vous devez configurer afin qu'il soit enregistré et qu'il apparaisse dans la boîte de dialogue Source de données.

Pour utiliser un fichier Excel comme source de données

Configurez le fichier avec l'Administrateur de source de données ODBC.
Sous l'onglet DSN fichier, cliquez sur Ajouter.
Dans la boîte de dialogue Créer une nouvelle source de données, sélectionnez un pilote Excel, puis cliquez sur Suivant.
Cliquez sur Parcourir et sélectionnez le nom du fichier à utiliser comme source de données.

Notes

Vous devrez peut-être sélectionner Tous les fichiers dans le menu déroulant pour afficher tous les fichiers .xls.

Cliquez sur Suivant, puis sur Terminer.
Dans la boîte de dialogue Installation ODBC pour Microsoft Excel, sélectionnez la version et le classeur de la base de données.

Utilisation dans un environnement multi-utilisateur

Si plusieurs utilisateurs sont connectés à une source de données, ils peuvent modifier les données lorsque vous les manipulez dans vos recordsets. De même, vos modifications peuvent affecter les recordsets des autres utilisateurs. Pour plus d'informations, consultez Recordset : modification des enregistrements par les recordsets (ODBC) et Transaction (ODBC).

Généralisation de la chaîne de connexion

Les Assistants utilisent une chaîne de connexion par défaut pour établir une connexion à une source de données. Utilisez cette connexion pour afficher des tables et colonnes lorsque vous développez votre application. Cependant, cette chaîne de connexion par défaut peut ne pas convenir aux connexions à la source de données de vos utilisateurs via votre application. Par exemple, leur source de données et le chemin d'accès de son emplacement peuvent être différents de ceux qui ont été utilisés lors du développement de votre application. Dans ce cas, vous devez réimplémenter la fonction membre CRecordset::GetDefaultConnect de façon plus générique et abandonner l'implémentation de l'Assistant. Par exemple, utilisez l'une des approches suivantes :

Enregistrez et gérez les chaînes de connexion en utilisant l'Administrateur ODBC.
Éditez la chaîne de connexion et retirez le nom de la source de données. La structure fournit ODBC comme source de données ; au moment de l'exécution, ODBC affiche une boîte de dialogue vous invitant à entrer le nom de la source de données ainsi que d'autres informations de connexion requises.
N'entrez que le nom de la source de données. ODBC vous demande l'ID utilisateur et le mot de passe, le cas échéant. Par exemple, la chaîne de connexion ressemble à l'exemple ci-dessous avant la généralisation :
```
CString CApp1Set::GetDefaultConnect()
{
   return "ODBC;DSN=afx;Trusted_Connection=Yes;";
}
```
Cette chaîne de connexion spécifie une connexion approuvée, qui utilise la sécurité intégrée de Windows NT. Il convient d'éviter de coder de manière irréversible un mot de passe, ou de spécifier un mot de passe vide puisque cela compromet sérieusement la sécurité. Vous pouvez plutôt attribuer à GetDefaultConnect une nouvelle chaîne de connexion afin qu'elle demande un ID utilisateur et un mot de passe.
```
// User must select data source and supply user ID and password:
    return "ODBC;";
// User ID and password required:
    return "ODBC;DSN=mydb;";
// Password required (myuserid must be replaced with a valid user ID):
    return "ODBC;DSN=mydb;UID=myuserid;";
// Hard-coded user ID and password (SECURITY WEAKNESS--AVOID):
    return "ODBC;DSN=mydb;UID=sa;PWD=777;";
```

Connexion à une source de données spécifique

Pour vous connecter à une source de données spécifique, votre source de données doit déjà être configurée à l'aide de l'Administrateur ODBC.

Pour vous connecter à une source de données spécifique

Construisez un objet CDatabase.
Appelez sa fonction membre OpenEx ou Open.

Pour plus d'informations sur la spécification d'une source de données autre que celle que vous avez spécifiée à l'aide d'un Assistant, consultez CDatabase::OpenEx ou CDatabase::Open dans MFC Reference.

Déconnexion d'une source de données

Vous devez fermer tous les recordsets ouverts avant d'appeler la fonction membre Close de CDatabase. Dans les recordsets associés à l'objet CDatabase que vous voulez fermer, toutes les instructions AddNew ou Edit et toutes les transactions en attente sont annulées.

Pour vous déconnecter d'une source de données

Appelez la fonction membre Close de l'objet CDatabase.
Détruisez l'objet, sauf si vous voulez le réutiliser.

Réutilisation d'un objet CDatabase

Vous pouvez réutiliser un objet CDatabase après une déconnexion, que ce soit pour vous reconnecter à la même source de données ou pour vous connecter à une source de données différente.

Pour réutiliser un objet CDatabase

Fermez la connexion initiale de l'objet.
Plutôt que de détruire l'objet, appelez à nouveau sa fonction membre OpenEx ou Open.

Voir aussi

Référence

CRecordset, classe

Concepts

Source de données (ODBC)

Source de données : détermination du schéma de la source de données (ODBC)

Partager via