直接通过ADO操作Access数据库

我在《VC知识库在线杂志》第十四期和第十五期上曾发表了两篇文章——“ 直接通过ODBC读、写Excel表格文件 ”和“ 直接通过DAO读、写Access文件 ”，先后给大家介绍了ODBC和DAO两种数据库访问技术的基本使用方法，这次要给大家介绍的是ADO数据库访问技术的使用方法。ADO(Active Data Object，活动数据对象)实际上是一种基于COM(组件对象模型)的自动化接口(IDispatch)技术，并以OLE DB(对象连接和镶入的数据库)为基础，经过OLE DB精心包装后的数据库访问技术，利用它可以快速的创建数据库应用程序。 ADO提供了一组非常简单，将一般通用的数据访问细节进行封装的对象。由于ODBC数据源也提供了一般的OLE DB Privider，所以ADO不仅可以应用自身的OLE DB Privider，而且还可以应用所有的ODBC驱动程序。关于OLE DB和ADO的其它详细情况，读者可以自行查阅相关书籍或MSDN，这里就不一一说明了。让我们直接步入主题：如何掌握ADO这种数据库访问技术。ADO 的操作方法和前面讲过的DAO的操作在很多方面存在相似之处，在这里，笔者为了更有效的说明它的使用方法，用VC6.0做了一个示例程序—— AdoRWAccess，这个示例程序可以直接通过ADO来操作Access数据库，示例程序的运行效果如下图所示：

 

在示例程序中我们仍采用原库结构，数据库名Demo.mdb，库内表名DemoTable，表内字段名为Name(姓名)和Age(年龄)的两个字段，来构造示例程序操作所需的Access数据库，这也和上两篇文章的示例源码中的库结构相兼容。
下面让我们看看ADO数据库访问技术使用的基本步骤及方法：
    首先，要用#import语句来引用支持ADO的组件类型库(*.tlb)，其中类型库可以作为可执行程序(DLL、EXE等)的一部分被定位在其自身程序中的附属资源里，如：被定位在msado15.dll的附属资源中，只需要直接用#import引用它既可。可以直接在Stdafx.h文件中加入下面语句来实现：

 
 

  
  

   
   

    
    [cpp] 
    
    view plain
    
    copy
    
    print
    
    ?
   
   
  
  
  
  
// 加入ADO支持库, jingzhou xu   
#import "c:/program files/common files/system/ado/msado15.dll" /   
    no_namespace /  
    rename ("EOF", "adoEOF")      
 
 
     

其中路径名可以根据自己系统安装的ADO支持文件的路径来自行设定。当编译器遇到#import语句时，它会为引用组件类型库中的接口生成包装类，#import语句实际上相当于执行了API涵数LoadTypeLib()。#import语句会在工程可执行程序输出目录中产生两个文件，分别为*.tlh(类型库头文件)及*.tli(类型库实现文件)，它们分别为每一个接口产生智能指针，并为各种接口方法、枚举类型，CLSID等进行声明，创建一系列包装方法。语句no_namespace说明ADO对象不使用命名空间，rename ("EOF", "adoEOF")说明将ADO中结束标志EOF改为adoEOF，以避免和其它库中命名相冲突。
    其次，在程序初始过程中需要初始化组件，一般可以用CoInitialize(NULL);来实现，这种方法在结束时要关闭初始化的COM，可以用下面语句CoUnInitialize();来实现。在MFC中还可以采用另一种方法来实现初始化COM，这种方法只需要一条语句便可以自动为我们实现初始化 COM和结束时关闭COM的操作，语句如下所示： AfxOleInit();
    接着，就可以直接使用ADO的操作了。我们经常使用的只是前面用#import语句引用类型库时，生成的包装类.tlh中声明的智能指针中的三个，它们分别是_ConnectionPtr、_RecordsetPtr和_CommandPtr。下面分别对它们的使用方法进行介绍

    在介绍前我们先写个函数，本例中添加为类变量的静态函数

[cpp] view plain copy print ?

1. //打印调用ADO控件时产生的详细错误信息   
2. void CAdoRWAccessDlg::dump_com_error(_com_error &e)  
3. {  
4.     CString ErrorStr;  
5.     _bstr_t bstrSource(e.Source());  
6.     _bstr_t bstrDescription(e.Description());  
7.     ErrorStr.Format( "/n/tADO Error/n/tCode = %08lx/n/tCode meaning = %s/n/tSource = %s/n/tDescription = %s/n/n",  
8.         e.Error(), e.ErrorMessage(), (LPCTSTR)bstrSource, (LPCTSTR)bstrDescription );  
9.     //在调试窗口中打印错误信息,在Release版中可用DBGView查看错误信息   
10.     ::OutputDebugString((LPCTSTR)ErrorStr);  
11. #ifdef _DEBUG   
12.     AfxMessageBox(ErrorStr, MB_OK | MB_ICONERROR);  
13. #endif     
14. }  

 

1、_ConnectionPtr智能指针，通常用于打开、关闭一个库连接或用它的Execute方法来执行一个不返回结果的命令语句(用法和 _CommandPtr中的Execute方法类似)。
——打开一个库连接。先创建一个实例指针，再用Open打开一个库连接，它将返回一个IUnknown的自动化接口指针。代码如下所示：

在CAdoRWAccessApp中添加一个public的成员变量

[cpp] view plain copy print ?

1. _ConnectionPtr  m_pConnection;  

在BOOL CAdoRWAccessApp::InitInstance()函数中

[cpp] view plain copy print ?

1. // 初始化COM,创建ADO连接等操作   
2. AfxOleInit();  
3. m_pConnection.CreateInstance(__uuidof(Connection));  
4. // 在ADO操作中建议语句中要常用try...catch()来捕获错误信息，   
5. // 因为它有时会经常出现一些想不到的错误。jingzhou xu   
6. try                   
7. {     
8.     // 打开本地Access库Demo.mdb   
9.     m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Demo.mdb","","",adModeUnknown);  
10.       
11. }  
12. catch(_com_error& e)  
13. {  
14.     //调用在CAdoRWAccessDlg中打印错误信息的静态函数   
15.     CAdoRWAccessDlg::dump_com_error(e);  
16.     return FALSE;  
17. }  

——关闭一个库连接（本例中在CAdoRWAccessApp::ExitInstance()）。如果连接状态有效，则用Close方法关闭它并赋于它空值。代码如下所示：

[cpp] view plain copy print ?

1. // 关闭ADO连接状态   
2. if(m_pConnection->State)  
3.     m_pConnection->Close();  
4. m_pConnection= NULL;  

2、_RecordsetPtr智能指针，可以用来打开库内数据表，并可以对表内的记录、字段等进行各种操作。
——打开数据表。打开库内表名为DemoTable的数据表，代码如下：

添加类成员变量

[cpp] view plain copy print ?

1. _RecordsetPtr   m_pRecordset;  

在CAdoRWAccessDlg::OnInitDialog()中

[cpp] view plain copy print ?

1. // 使用ADO创建数据库记录集   
2. m_pRecordset.CreateInstance(__uuidof(Recordset));  
3. // 在ADO操作中建议语句中要常用try...catch()来捕获错误信息，   
4. // 因为它有时会经常出现一些想不到的错误。jingzhou xu   
5. try  
6. {  
7.     m_pRecordset->Open("SELECT * FROM DemoTable",                // 查询DemoTable表中所有字段   
8.                         theApp.m_pConnection.GetInterfacePtr(),  // 获取库接库的IDispatch指针   
9.                         adOpenDynamic,  
10.                         adLockOptimistic,  
11.                         adCmdText);  
12. }  
13. catch(_com_error& e)  
14. {  
15.     dump_com_error(e);  
16. }  

——读取表内数据。将表内数据全部读出并显示在列表框内，m_AccessList为列表框的成员变量名。如果没有遇到表结束标志adoEOF，则用 GetCollect(字段名)或m_pRecordset->Fields->GetItem(字段名)->Value方法，来获取当前记录指针所指的字段值，然后再用MoveNext()方法移动到下一条记录位置。代码如下所示：

 

[cpp] view plain copy print ?

1. _variant_t var;  
2. CString strName,strAge;  
3. // 清空列表框   
4. m_AccessList.ResetContent();  
5. strName=strAge="";  
6. // 在ADO操作中建议语句中要常用try...catch()来捕获错误信息，   
7. // 因为它有时会经常出现一些想不到的错误。jingzhou xu   
8. try  
9. {  
10.     if(!m_pRecordset->BOF)  
11.         m_pRecordset->MoveFirst();  
12.     else  
13.     {  
14.         AfxMessageBox("表内数据为空");  
15.         return;  
16.     }  
17.     // 读入库中各字段并加入列表框中   
18.     while(!m_pRecordset->adoEOF)  
19.     {  
20.         var = m_pRecordset->GetCollect("Name");  
21.         if(var.vt != VT_NULL)  
22.             strName = (LPCSTR)_bstr_t(var);  
23.         var = m_pRecordset->GetCollect("Age");  
24.         if(var.vt != VT_NULL)  
25.             strAge = (LPCSTR)_bstr_t(var);  
26.         m_AccessList.AddString( strName + " --> "+strAge );  
27.         m_pRecordset->MoveNext();  
28.     }  
29.     // 默认列表指向第一项，同时移动记录指针并显示   
30.     m_AccessList.SetCurSel(0);  
31.     OnSelchangeListaccess();  
32. }  
33. catch(_com_error& e)  
34. {  
35.     dump_com_error(e);  
36. }  

 

——插入记录。可以先用AddNew()方法新增一个空记录，再用PutCollect(字段名,值)输入每个字段的值，最后再Update()更新到库中数据既可。其中变量m_Name和m_Age分别为姓名及年龄编辑框的成员变量名。代码所下所示：

[cpp] view plain copy print ?

1. // 在ADO操作中建议语句中要常用try...catch()来捕获错误信息，   
2. // 因为它有时会经常出现一些想不到的错误。jingzhou xu   
3. try  
4. {  
5.     // 写入各字段值   
6.     m_pRecordset->AddNew();  
7.     m_pRecordset->PutCollect("Name", _variant_t(m_Name));  
8.     m_pRecordset->PutCollect("Age", atol(m_Age));  
9.     m_pRecordset->Update();  
10.     AfxMessageBox("插入成功!");  
11.     // 更新显示其库内容   
12.     int nCurSel = m_AccessList.GetCurSel();  
13.     OnReadAccess();  
14.     m_AccessList.SetCurSel(nCurSel);  
15.     // 移动记录指针到新的位置   
16.     OnSelchangeListaccess();  
17. }  
18. catch(_com_error& e)  
19. {  
20.     dump_com_error(e);  
21. }  

——移动记录指针。移动记录指针可以通过MoveFirst()方法移动到第一条记录、MoveLast()方法移动到最后一条记录、 MovePrevious()方法移动到当前记录的前一条记录、MoveNext()方法移动到当前记录的下一条记录。但我们有时经常需要随意移动记录指针到任意记录位置时，可以使用Move(记录号)方法来实现，注意: Move()方法是相对于当前记录来移动指针位置的，正值向后移动、负值向前移动，如：Move(3)，当前记录是3时，它将从记录3开始往后再移动3条记录位置。代码如下所示：

[cpp] view plain copy print ?

1. try  
2. {  
3.     int curSel = m_AccessList.GetCurSel();    
4.     // 先将指针移向第一条记录，然后就可以相对第一条记录来随意移动记录指针   
5.     m_pRecordset->MoveFirst();  
6.     m_pRecordset->Move(long(curSel));  
7.       
8. }  
9. catch(_com_error& e)  
10. {  
11.     dump_com_error(e);  
12. }   

——修改记录中字段值。可以将记录指针移动到要修改记录的位置处，直接用PutCollect(字段名，值)将新值写入并Update()更新数据库既可。可以用上面方法移动记录指针，修改字段值代码如下所示：

[cpp] view plain copy print ?

1. // 修改当前记录的字段值   
2. try  
3. {  
4.     m_pRecordset->PutCollect("Name", _variant_t(m_Name));  
5.     m_pRecordset->PutCollect("Age", atol(m_Age));  
6.     m_pRecordset->Update();  
7.     // 重新读入库记录更新显示   
8.     int nCurSel = m_AccessList.GetCurSel();  
9.     OnReadAccess();  
10.     m_AccessList.SetCurSel(nCurSel);  
11.     // 移动记录指针到新的位置   
12.     OnSelchangeListaccess();  
13. }  
14. catch(_com_error& e)  
15. {  
16.     dump_com_error(e);  
17. }  

——删除记录。删除记录和上面修改记录的操作类似，先将记录指针移动到要修改记录的位置，直接用Delete()方法删除它并用Update()来更新数据库既可。代码如下所示：

[cpp] view plain copy print ?

1. try  
2. {  
3.     // 删除当前行记录   
4.     m_pRecordset->Delete(adAffectCurrent);  
5.     m_pRecordset->Update();  
6.     // 删除列表中当前值   
7.     int nCurSel = m_AccessList.GetCurSel();  
8.     m_AccessList.DeleteString(nCurSel);  
9.     if(nCurSel == 0 && (m_AccessList.GetCount() != 0))  
10.         m_AccessList.SetCurSel(nCurSel);  
11.     else if(m_AccessList.GetCount() != 0)  
12.         m_AccessList.SetCurSel(nCurSel-1);  
13.       
14.     // 移动记录指针到新的位置   
15.     OnSelchangeListaccess();  
16. }  
17. catch(_com_error& e)  
18. {  
19.     dump_com_error(e);  
20. }  

——关闭记录集。直接用Close方法关闭记录集并赋于其空值。代码如下所示：

[cpp] view plain copy print ?

1. // 关闭记录集   
2. if ( m_pRecordset != NULL )  
3. {  
4.     m_pRecordset->Close();  
5.     m_pRecordset.Release();  
6.     m_pRecordset = NULL;  
7. }  

3、CommandPtr智能指针，可以使用_ConnectionPtr或_RecordsetPtr来执行任务，定义输出参数，执行存储过程或SQL 语句。
——执行SQL语句。先创建一个_CommandPtr实例指针，再将库连接和SQL语句做为参数，执行Execute()方法既可。代码如下所示：

[cpp] view plain copy print ?

1. _CommandPtr     m_pCommand;  
2. m_pCommand.CreateInstance(__uuidof(Command));  
3. m_pCommand->ActiveConnection = theApp.m_pConnection;  // 将库连接赋于它   
4. m_pCommand->CommandText = _bstr_t((LPCTSTR)m_strCommand);  // SQL语句   
5. try   
6. {  
7.     // 执行SQL语句，返回记录集,此记录不能做插入操作   
8.     // 故为了不和m_pRecordset相冲突, 放入新定义的m_pRecordset1   
9.     m_pRecordset1 = m_pCommand->Execute( NULL, NULL, adCmdText);   
10. }  
11. catch(_com_error& e)  
12. {  
13.     dump_com_error(e);  
14. }  

——执行存储过程。执行存储过程的操作和上面执行SQL语句类似，不同点仅是CommandText参数中不再是SQL语句，而是存储过程的名字，如 Demo。另一个不同点就是在Execute()中参数由adCmdText(执行SQL语句)，改为adCmdStoredProc来执行存储过程。如果存储过程中存在输入、输出参数的话，需要使用到另一个智能指针_ParameterPtr来逐次设置要输入、输出的参数信息，并将其赋于 _CommandPtr中Parameters参数来传递信息，有兴趣的读者可以自行查找相关书籍或MSDN。执行存储过程的代码如下所示：

[cpp] view plain copy print ?

1. _CommandPtr     m_pCommand;  
2. m_pCommand.CreateInstance(__uuidof(Command));  
3.   m_pCommand->ActiveConnection = m_pConnection;  // 将库连接赋于它   
4. m_pCommand->CommandText = "Demo";    
5.   m_pCommand->Execute(NULL,NULL, adCmdStoredProc);     

最后，如果想知道详细实现细节的话，可以在下载示例源码后，仔细查看源码既可(内有详细注释)。

联系方式： 地址：陕西省西安市劳动路2号院六单元 
邮编：710082
作者EMAIL：jingzhou_xu@163.net
未来工作室(Future Studio)

 

本文仅仅是修改了打印ADO错误的地方，使得打印错误信息更全面详细一些（使我想起了我调用每个windows的非void返回值API，总喜欢用GetLastError+FormatMessage打印详细错误出来）。另把CommandPtr部分给加到代码中了。

 

注：需要拷贝网页上的代码点击代码上的“copy to clipboard”或者“view plain”（字太小找不到，CTRL+F）

 

后记：个人强烈建议所有的ADO操作都加上try...catch...打印_com_error的详细错误消息，比如本文中的 dump_com_error。