Classe CDatabase

Article
03/26/2013

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.

[!REMARQUE]

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.