CDatabase类

 

CDatabase对象表示到数据源的连接，通过它可以操作数据源。数据源是位于一些数据库管理系统（DBMS）的数据的指定实例，包括MicrosoftSQLServer，MicrosoftAccess，BorlanddBASE和xBASE。在应用中可以同时使一个或多个CDatabase对象活动。

注意：

如果在处理数据访问对象（DAO）类而不是开放数据库连接（ODBC）类，可使用类CDaoDatabase。

为使用CDatabase，构造一个CDatabase对象并调用它的OpenEx成员函数。这打开了一个连接。在接着构造CRecordset对象以操纵连接的数据源时，向CDatabase对象传递记录集构造程序指针。完成使用连接时调用Close成员函数并销毁CDatabase对象。Close关闭以前没有关闭的任何记录集。

#include<afxdb.h>

1.      建立连接：

要建立与数据源的连接，首先应构造一个CDatabase对象，然后再调用CDatabase的Open成员函数Open函数负责建立连接，其声明为：

virtual BOOL Open( LPCTSTR lpszDSN, BOOL bExclusive = FALSE, BOOL bReadOnly = FALSE, LPCTSTR lpszConnect =＂ODBC;＂, BOOL bUseCursorLib = TRUE ); throw( CDBException, CMemoryException );

说明：

1)      参数lpszDSN指定了数据源名（构造数据源的方法将在后面介绍），在lpszConnect参数中也可包括数据源名，此时lpszDSN必需为NULL，若在函数中未提供数据源名且使lpszDSN为NULL，则会显示一个数据源对话框，用户可以在该对话框中选择一个数据源。

2)      参数bExclusive说明是否独占数据源，由于目前版本的类库还不支持独占方式，故该参数的值应该是FALSE，这说明数据源是被共享的。

3)      参数bReadOnly若为TRUE则对数据源的连接是只读的。

4)      参数lpszConnect指定了一个连接字符串，连接字符串中可以包括数据源名、用户帐号(ID)和口令等信息，字符串中的“ODBC”表示要连接到一个ODBC数据源上。

5)      参数bUseCursorLib若为TRUE，则会装载光标库，否则不装载，快照需要光标库，动态集不需要光标库。

6)      若连接成功，函数返回TRUE，若返回FALSE，则说明用户在数据源对话框中按了Cancel按钮。若函数内部出现错误，则框架会产生一个异常。

例子：

1)      CDatabase m_db; //在文档类中嵌入一个CDatabase对象

2)      //连接到一个名为＂Student Registration＂的数据源

m_db.Open("Student Registration");

3)      //在连接数据源的同时指定了用户帐号和口令

m_db.Open(NULL,FALSE,FALSE,"ODBC;DSN=Student Registration;UID=ZYF;PWD=1234");

4)      m_db.Open(NULL); //将弹出一个数据源对话框

2.      要从一个数据源中脱离，可调用函数Close。在脱离后，可以再次调用Open函数来建立一个新的连接。

3.      调用IsOpen可判断当前是否有一个连接。

4.      调用GetConnect可返回当前的连接字符串。

5.      相关函数声明：

virtual void Close( );

BOOL IsOpen( ) const; //返回TRUE则表明当前有一个连接

const CString& GetConnect( ) const;

6.      CDatabase的析构函数会调用Close，所以只要删除了CDatabase对象就可以与数据源脱离。

7.      CDatabase类成员

数据成员

m_hdbc

对数据源的开放数据库连接（ODBC）连接句柄。类型HDBC

构造函数

CDatabase	构造一个CDatabase对象。必须通过调用OpenEx或Open初始化这个对象
Open	建立到数据源的一个连接（通过ODBC驱动程序）
OpenEx	建立到数据源的一个连接（通过ODBC驱动程序）
Close	关闭数据源连接

数据库属性

GetConnect	返回用于连接CDatabase对象和数据源的ODBC连接字符串
IsOpen	如果CDatabase对象当前与数据源连接，则返回非零
GetDatabaseName	返回当前使用的数据库名字
CanUpdate	如果CDatabase可更新（不是只读的），则返回非零
CanTransact	如果数据源支持事务，则返回非零
SetLoginTimeout	设置数据源连接试图超时的秒数
SetQueryTimeout	设置数据库查询操作超时的秒数。影响以后的所有记录集调用：Open，AddNew，Edit和Delete
GetBookmarkPersistence	标识记录集对象上书签持久化操作
GetCursorCommitBehavior	标识在打开的记录集对象上提交事务的效果
GetCursorRollbackBehavior	标识在打开的记录集对象上回滚事务的效果

数据库操作

BeginTrans	在连接的数据源上开始“事务”──类CRecordset的一系列可回滚的AddNew，Edit，Delete和Update成员函数调用。数据源必须支持事务才能使BeginTrans有效
BindParameters	允许在调用CDatabase::ExecuteSQL前绑定参数
CommitTrans	完成由从BeginTrans开始的事务。执行这个事务中改变数据源的命令
Rollback	回滚当前事务期间所做变化，数据源返回到BeginTrans调用时定义的未改变的以前状况
Cancel	取消第二个线程的异步操作或处理
ExecuteSQL	执行一条SQL语句。不返回数据记录

数据库覆盖

OnSetOptions

框架调用以设置标准连接选项。缺省实现设置查询超时值。可以通过调用SetQueryTimeout提前建立这些选项