Partager via


CDatabase, classe

Représente une connexion à une source de données, dans laquelle vous pouvez traiter la source de données.

class CDatabase : public CObject

Membres

Constructeurs publics

Nom

Description

CDatabase::CDatabase

Construit un objet CDatabase. Vous devez initialiser l'objet en appelant OpenEx ou Ouvrir.

Méthodes publiques

Nom

Description

CDatabase::BeginTrans

Commence une transaction «  » — une série d'appels réversibles à AddNew, à Modifier, à Supprimer, et les fonctions membres de Mettre à jour de la classe CRecordset — sur la source de données connectée. La source de données doit prendre en charge les transactions pour BeginTrans a aucun effet.

CDatabase::BindParameters

Vous permet de définir des paramètres de manipulation avant d'appeler CDatabase::ExecuteSQL.

CDatabase::Cancel

Annule une opération asynchrone ou un processus d'un deuxième thread.

CDatabase::CanTransact

Retourne une valeur différente de zéro si la source de données prend en charge les transactions.

CDatabase::CanUpdate

Retourne une valeur différente de zéro si l'objet d' CDatabase peut être mise à jour (non en lecture seule).

CDatabase::Close

Ferme la connexion à la source de données.

CDatabase::CommitTrans

Termine une transaction démarrée par BeginTrans. Les commandes de la transaction qui modifient la source de données sont exécutées.

CDatabase::ExecuteSQL

Exécute une instruction SQL. Aucun enregistrement de données n'est retourné.

CDatabase::GetBookmarkPersistence

Identifie les opérations dans lesquelles les signets persistent sur des objets recordset.

CDatabase::GetConnect

Retourne la chaîne de connexion ODBC utilisée pour connecter l'objet d' CDatabase à une source de données.

CDatabase::GetCursorCommitBehavior

Identifie l'effet de valider une transaction sur un objet recordset ouvert.

CDatabase::GetCursorRollbackBehavior

Identifie l'effet de restauration d'une transaction sur un objet recordset ouvert.

CDatabase::GetDatabaseName

Retourne le nom de la base de données en cours de utilisation.

CDatabase::IsOpen

Retourne une valeur différente de zéro si l'objet d' CDatabase est actuellement connecté à une source de données.

CDatabase::OnSetOptions

Appelé par l'infrastructure pour définir des options de connexion standard. L'implémentation par défaut définit la valeur du délai d'expiration de la requête. Vous pouvez générer ces options d'avance en appelant SetQueryTimeout.

CDatabase::Open

Établit une connexion à une source de données (par le biais d'un pilote ODBC).

CDatabase::OpenEx

Établit une connexion à une source de données (par le biais d'un pilote ODBC).

CDatabase::Rollback

Modifications de l'inverse apportées pendant la transaction en cours. La source de données retourne à son état précédent, comme défini à l'appel de BeginTrans , inchangé.

CDatabase::SetLoginTimeout

Définit le nombre de secondes après quoi une tentative de connexion de source de données chronomètrera.

CDatabase::SetQueryTimeout

Définit le nombre de secondes après quoi les opérations de requête de base de données chronomètreront. Affecte tout le recordset suivant Ouvrir, AddNew, Modifier, et appels de Supprimer .

Données membres publiques

Nom

Description

CDatabase::m_hdbc

Handle de connexion ODBC (Open Database Connectivity) à une source de données. Tapez HDBC.

Notes

Une source de données est une instance spécifique de données hébergées par un certain système de gestion de base de données (SGBD). Les exemples incluent le dBASE Microsoft SQL Server, Microsoft Access, de Borland, et le xBASE. Vous pouvez avoir un ou plusieurs objets d' CDatabase actifs à la fois dans votre application.

Notes

Si vous utilisez DAO (DAO) classe plutôt que les classes ODBC (Open Database Connectivity), utilisez la classe CDaoDatabase à la place.Pour plus d'informations, consultez l'article présentation : Programmation de bases de données.

Pour utiliser CDatabase, construisez un objet d' CDatabase et appelez sa fonction membre d' OpenEx . Cela ouvre une connexion. Lorsque vous construisez ensuite des objets d' CRecordset pour s'exécuter sur la source de données connectée, passez le constructeur de recordsets un pointeur vers l'objet d' CDatabase . Lorsque vous avez fini d'utiliser la connexion, appelez la fonction membre de Fermer et détruisez l'objet d' CDatabase . Fermer ferme tous les recordsets que vous ne vous êtes pas fermés précédemment.

Pour plus d'informations sur CDatabase, consultez les articles source de données (ODBC) et présentation : Programmation de bases de données.

Hiérarchie d'héritage

CObject

CDatabase

Configuration requise

Header: afxdb.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie

CRecordset, classe