04CDatabase类

CDatabase类

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

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

　

参数lpszDSN指定了数据源名（构造数据源的方法将在后面介绍），在lpszConnect参数中也可包括数据源名，此时lpszDSN必需为NULL，若在函数中未提供数据源名且使lpszDSN为NULL，则会显示一个数据源对话框，用户可以在该对话框中选择一个数据源．参数bExclusive说明是否独占数据源，由于目前版本的类库还不支持独占方式，故该参数的值应该是FALSE，这说明数据源是被共享的．参数bReadOnly若为TRUE则对数据源的连接是只读的．参数lpszConnect指定了一个连接字符串，连接字符串中可以包括数据源名、用户帐号(ID)和口令等信息，字符串中的＂ODBC＂表示要连接到一个ODBC数据源上．参数bUseCursorLib若为TRUE，则会装载光标库，否则不装载，快照需要光标库，动态集不需要光标库． 若连接成功，函数返回TRUE，若返回FALSE，则说明用户在数据源对话框中按了Cancel按钮。若函数内部出现错误，则框架会产生一个异常。

下面是一些调用Open函数的例子。

　

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

　

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

m_db.Open("Student Registration");

　

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

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

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

　

要从一个数据源中脱离，可调用函数Close。在脱离后，可以再次调用Open函数来建立一个新的连接．调用IsOpen可判断当前是否有一个连接，调用GetConnect可返回当前的连接字符串。函数的声明为

virtual void Close( );

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

const CString& GetConnect( ) const;

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