CDatabase对象表示到数据源的连接,通过它可以操作数据源。数据源是位于一些数据库管理系统(DBMS)的数据的指定实例,包括MicrosoftSQLServer,MicrosoftAccess,BorlanddBASE和xBASE。在应用中可以同时使一个或多个CDatabase对象活动。
注意:
如果在处理数据访问对象(DAO)类而不是开放数据库连接(ODBC)类,可使用类CDaoDatabase。
为使用CDatabase,构造一个CDatabase对象并调用它的OpenEx成员函数。这打开了一个连接。在接着构造CRecordset对象以操纵连接的数据源时,向CDatabase对象传递记录集构造程序指针。完成使用连接时调用Close成员函数并销毁CDatabase对象。Close关闭以前没有关闭的任何记录集。
#include
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提前建立这些选项 |