ADO编程详解(C++)
一、概述
ADO即Microsoft ActiveXData Object，是Microsoft继ODBC之后，基于OLE DB技术的一种数据库操作技术，使您能够编写通过 OLE DB 提供者对在数据库服务器中的数据进行访问和操作的应用程序。ADO同OLE DB、数据库之间的关系可以用下图来表示：
其主要优点是易于使用、高速度、低内存支出和占用磁盘空间较少。ADO 支持用于建立基于客户端/服务器和 Web 的应用程序的主要功能。
二、ADO初步认识
在此介绍的ADO编程技术都是基于C++的，要熟练掌握如何用ADO操作数据库，首先对ADO技术得有个总体的了解，AD0主要由几个对象组成：Connection、Command、Paramenter、Recorderset、Fields、Error、Property对象，对数据库的操作，都是通过这几个对象来进行的，对象模型的关系图如下：
· Connection对象
在数据库应用里操作数据源都必须通过该对象，这是数据交换的环境。Connection对象代表了同数据源的一个会话，在客户/服务器模型里，这个会话相当于同服务器的一次网络连接。不同的数据提供者提供的该对象的集合、方法和属性不同。
借助于Connection对象的集合、方法和属性，可以使用Open和Close方法建立和释放一个数据源连接。使用Execute方法可以执行一个数据操作命令，使用BeginTrans、CommitTrans和RollbackTrans方法可以启动、提交和回滚一个处理事务。通过操作the Errors 集合可以获取和处理错误信息，操作CommandTimeout属性可以设置连接的溢出时间，操作ConnectionString属性可以设置连接的字符串，操作Mode属性可以设置连接的模式，操作Provider属性可以指定OLE DB提供者。
· Command对象
Command对象是一个对数据源执行命令的定义，使用该对象可以查询数据库并返回一个Recordset对象，可以执行一个批量的数据操作，可以操作数据库的结构。不同的数据提供者提供的该对象的集合、方法和属性不同。
借助于Command对象的集合、方法和属性，可以使用Parameters集合制定命令的参数，可以使用Execute方法执行一个查询并将查询结果返回到一个Recordset对象里，操作CommandText属性可以为该对象指定一个命令的文本，操作CommandType属性可以指定命令的类型，操作Prepared可以得知数据提供者是否准备好命令的执行，操作CommandTimeout属性可以设置命令执行的溢出时间。
· Parameter对象
Parameter对象在Command对象中用于指定参数化查询或者存储过程的参数。大多数数据提供者支持参数化命令，这些命令往往是已经定义好了的，只是在执行过程中调整参数的内容。
借助于Parameter对象的集合、方法和属性，可以通过设置Name属性指定参数的名称，通过设置Value属性可以指定参数的值，通过设置Attributes和Direction、Precision、NumericScale、Size与Type 属性可以指定参数的信息，通过执行AppendChunk方法可以将数据传递到参数里。
· Recordset对象
如果执行的命令是一个查询并返回存放在表中的结果集，这些结果集将被保存在本地的存储区里，Recordset对象是执行这种存储的ADO对象。通过Recordset对象可以操纵来自数据提供者的数据，包括修改和更新行、插入和删除行。
ADO定义了如表
| 光标类型 |
描述 |
| adOpenDynamic |
允许添加、修改和删除记录，支持所有方式的光标移动，其他用户的修改可以在联机以后仍然可见 |
| adOpenKeyset |
类似于adOpenDynamic光标，它支持所有类型的光标移动，但是建立连接以后其他用户对记录的添加不可见，其他用户对记录的删除和对数据的修改是可见的。支持书签操作 |
| adOpenStatic |
支持各种方式的光标移动，但是建立连接以后其他用户的行添加、行删除和数据修改都不可见，支持书签操作 |
| adOpenForwardOnly |
只允许向前存取，而且在建立连接以后，其他用户的行添加、行删除和数据修改都不可见，支持书签操作 |
ADO定义了如表
| 锁定类型 |
描述 |
| adLockReadOnly |
（缺省）数据只读 |
| adLockPessimistic |
锁定操作的所有行，也称为消极锁定 |
| adLockOptimistic |
只在调用Update方法时锁定操作的行，也称为积极锁定 |
| adLockBatchOptimistic |
在批量更新时使用该锁定，也称为积极批量锁定 |
ADO定义了如表
| 光标服务位置 |
描述 |
| adUseNone |
不使用光标服务位置 |
| adUseClient |
使用客户端光标 |
| adUseServer |
（缺省）使用数据服务端或者驱动提供端光标 |
借助于Recordset对象的集合、方法和属性，可以通过设置CursorType属性设置记录集的光标类型，通过设置CursorLocation属性可以指定光标位置，通过读取BOF 和EOF属性的值，获知当前光标在记录集里的位置是在最前或者最后，通过执行MoveFirst、MoveLast、MoveNext和MovePrevious 方法移动记录集里的光标，通过执行Update方法可以更新数据修改，通过执行AddNew方法可以执行行插入操作，通过执行Delete方法可以删除行。
· Field对象
Recordset对象的一个行由一个或者多个Fields对象组成，如果把一个Recordset对象看成一个二维网格表，那么Fields对象就是这些列。这些列里保存了列的名称、数据类型和值，这些值是来自数据源的真正数据。为了修改数据源里的数据，必须首先修改Recordset对象各个行里Field对象里的值，最后Recordset对象将这些修改提交到数据源。
借助于Field对象的集合、方法和属性，可以通过读取Name属性，获知列的名称。通过操作Value属性可以改变列的值，通过读取Type、Precision和NumericScale 属性，可获知列的数据类型、精度和小数位的个数，通过执行AppendChunk 和GetChunk 方法可以操作列的值。
· Error对象
Error对象包含了ADO数据操作时发生错误的详细描述，ADO的任何对象都可以产生一个或者多个数据提供者错误，当错误发生时，这些错误对象被添加到Connection 对象的Errors集合里。当另外一个ADO对象产生一个错误时，Errors集合里的Error对象被清除，新的Error对象将被添加到Errors集合里。
借助于Errosr对象的集合、方法和属性，可以通过读取Number和Description属性，获得ADO错误号码和对错误的描述，通过读取Source属性得知错误发生的源。
· Property对象
Property对象代表了一个由提供者定义的ADO对象的动态特征。ADO对象有两种类型的Property对象：内置的和动态的。内置的Property对象是指那些在ADO里实现的在对象创建时立即可见的属性，可以通过域作用符直接操作这些属性。动态的Property对象是指由数据提供者定义的底层的属性，这些属性出现在ADO对象的Properties集合里，例如，如果一个Recordset 对象支持事务和更新，这些属性将作为Property对象出现在Recordset对象的Properties集合里。动态属性必须通过集合进行引用，比如使用下面的语法：
MyObject.Properties(0)
或者
MyObject.Properties("Name")
不能删除任何类型的属性对象。借助于Property对象的集合、方法和属性，可以通过读取Name属性获得属性的名称，通过读取Type属性获取属性的数据类型，通过读取Value属性获取属性的值。
三、ADO编程
通常情况下，一个基于ADO的数据库应用使用如下过程操作数据源里的数据：
(1) 创建一个Connection对象。定义用于连接的字符串信息，包括数据源名称、用户ID、口令、连接超时、缺省数据库以及光标的位置。一个Connection 对象代表了同数据源的一次会话。可以通过Connection 对象控制事务，即执行BeginTrans、CommitTrans和RollbackTrans方法。
(2) 打开数据源，建立同数据源的连接。
(3) 执行一个SQL命令。一旦连接成功，就可以运行查询了。可以以异步方式运行查询，也可以异步地处理查询结果，ADO会通知提供者后台提供数据。这样可以让应用程序继续处理其它事情而不必等待。
(4) 使用结果集。完成了查询以后，结果集就可以被应用程序使用了。在不同的光标类型下，可以在客户端或者服务器端浏览和修改行数据。
(5) 终止连接。当完成了所有数据操作后，可以销毁这个同数据源的连接。
首先说句题外话，关于ADO各个对象的使用，可查看《ADL帮助文档》，如下是文档下载链接：http://download.csdn.net/detail/mingojiang/5017094
3.1准备工作
引入ADO库
ADO是以DLL封装的，要使用ADO，首先得引入其DLL库，引入ADO类型库的方法有多种，在此我们就介绍一种----通过预处理指令#import引入。一般情况下，在windows操作系统的Program Files\Common Files\System\ado目录下都有一个msado*.dll文件,根据windows版本不同,该文件可以是msado1.dll、msado15.dll、msado2.dll，对于此文件，版本不一样，可能导致一些冲突，如：系统自带的msado*.dll可能与程序编译所用的版本不一样，可能会导致一些异常，那么对于这种情况，我个人一般的做法是，在软件目录下面带上msado*.dll文件，这样就排除了对软件运行环境的依赖。
Ado类型库引入后，程序在编译过程中，VC++会读出msado*.dll中的类型库信息，自动产生两个该类型库的头文件和实现文件msado15.tlh和msado15.tli（在您的Debug或Release目录下）。在这两个文件里定义了ADO的所有对象和方法，以及一些枚举型的常量等。以下是引入方法：
//收下引入命令会导致4146警告，通过些命令去除
#pragma warning(disable:4146)
//引号里面的路径，可绝对的，可相对的
#import"..\CommFile\Lib\msado15.dll" named_guids \
//重命名EOF与BOF以免与其他命名空间冲突
rename("EOF","adoEOF"),rename("BOF","adoBOF")
#pragma warning(default:4146)
using namespace ADODB;
初始化COM
ADO是COM组件，使用任何COM组件的时候，都要先初始化COM，其实就是在使用COM组件前调用一个API----CoInitialize()，在使用ADO对象之前调用即可，以下为代码：
HRESULT hr =CoInitialize(NULL);
ASSERT(SUCCEEDED(hr));//返回值可判断初始化COM是否成功，请用SUCCEEDED来判断
一般情况下，使用完COM之后，调用反初始化COM函数----CoUninitialize()。一般会在数据库访问封装类的析构函数中调用。
3.2连接数据库
通过创建连接对象连接数据库，首先创建一个指向Connection的指针_ConnectionPtr，以下是创建连接的源码：
_ConnectionPtr m_pConn;
HRESULT hr =CoInitialize(NULL);
ASSERT(SUCCEEDED(hr));
if (NULL ==m_pConn) {
try
{ //Connecting
if ( !FAILED(m_pConn.CreateInstance(_uuidof(Connection)))){ //设置连接超时时间
m_pConn->CommandTimeout= 30; //设置连接超时值，单位为秒
if (!FAILED(m_pConn->Open((_bstr_t)(m_szConnStr), "", "",adModeUnknown)))
returntrue;
}
}
catch(_com_error e){
char szLog[MAX_BUFF];memset(szLog, 0, MAX_BUFF);
sprintf(szLog, "连接数据库错误:%s\n",(char *)(e.Description()));
}
return false;
}
Open方法中， 第一个参数就是连接串，这个连接串如何获得？VC++6.0中有工具，不过太过麻烦，而且获得的串还得复制，不方便，下面介绍一种方便实用获得连接串的方法。
获得连接串
创建一个记事本文件，把文件名(包括扩展名)改成“Test.udl”，双击打开，如下图：
第一个红色框里有三个记录，针对ACCESS数据库可选前三项中的一项。Oracle数据库选第二个框，第三个框是对MS Sql数据库的。自己所连的数据库是什么类型，自己选择，然后点下一步，如图：
第一个框输入数据库所在服务器的IP，或者计算机名，或者域名之类，第二个框输入登录数据库的用户名与密码，勾上第三个框中的复选框，这时，如果你上面几项的资料都没错的话，第四个框中会出现你所连接的数据库中的所有的库名，然后你选一个你所要连接的库，点击第五个框中的“测试连接”按钮，如果弹出连接成功之类的提示，那么恭喜，成功了，点“确定”按钮关闭窗口，再以记事本方式打开此文件，你就会看到你所需的连接串了，效果图如下：
红色框中的串就是连接串，把这一串数据复制下来，赋给Open方法中的第一个参数，就OK了，但是这是不是还是有点麻烦呀，要复制来复制去的，这还有更便捷的方法，以上方法不变，只是使用连接串的方法做些改进，只要把“Test.udl”文件的路径赋给Open方法的第一个参数即可，如下：
char szUdlPath[] ={".\\Test.udl"};//可相对路径，亦可绝对路径
sprintf(m_szConnStr,"File Name=%s", szUdlPath);//前面是固定格式
按这种方法，发行软件的时候，只要相应目录下，放一个“Test.udl”文件即可，数据库的连接可自由配制，是不是相当便捷实用呀。
3.3获得记录集
与Connection对象一样，首先是创建一个RecordSet对象指针，再创建对象
try
{
if(!FAILED(m_pRecord.CreateInstance(__uuidof(Recordset)))) {
HRESULT hr = 0;
//当连接断开，或者连接对象没有连接的情况下，通过连接串获得记录集
if (NULL == m_pConn ||adStateClosed == m_pConn->State)
hr =m_pRecord->Open((_bstr_t)szSQL, _variant_t(m_szConnStr),
adOpenKeyset, adLockOptimistic,adCmdText);
else//连接对象处理正常连接状态下，直接使用
hr = m_pRecord->Open((_bstr_t)szSQL,m_pConn.GetInterfacePtr(), adOpenKeyset,
adLockOptimistic,adCmdText);
if (SUCCEEDED(hr))
bResult = true;
}
}
catch (_com_errore)
{
char szLog[MAX_BUFF]; memset(szLog, 0,MAX_BUFF);
sprintf(szLog, "执行SQL查询命令错误:%s[%s]",(char *)(e.Description()), szSQL);
}
以上代码中的szSQL是select串，就是查询语句，if与else中m_pRecord有两种Open方式，第一种是连接对象断开，或者没连接状态下，通过连接串获得记录集，第二种连接正常情况下，那么无需再连接，直接通过连接对象获得连接信息。至此，记住集已成功获得，下面是怎么提取数据的问题了。
while(!IsRecordEOF()){//判断是否到了记录结尾
UINT nCarID = 0;
char sCarMark[MAX_BUFF];memset(sCarMark, 0, MAX_BUFF);
CollectMsg("CARID" , nCarID ) ;//第一个参数，传列名
CollectMsg("Car_Mark" , sCarMark, MAX_BUFF) ;
RecordMoveNext();//移动到下一个记录
}
CloseRecord ();//关闭记录集
以下代码是以上代码的函数实现：
Bool IsRecordEOF()
{
bool bResult = true;
if (NULL != m_pRecord) {
if (!m_pRecord->adoEOF)
bResult = false;
}
return bResult;
}
Bool CollectMsg(const char *szColumnName, int&iTemp )
{
bool bResult = false;
if (adStateClosed !=m_pRecord->State) {
try{
_variant_t Column(szColumnName);
_variant_t RusultGet= m_pRecord->Fields->GetItem(Column)->Value;
iTemp =RusultGet.intVal;
bResult = true;
}
catch(_com_error e){
charszLog[MAX_BUFF]; memset(szLog, 0, MAX_BUFF);
sprintf(szLog,"%s", (char *)(e.Description()));
m_WriteLog.WriteLog(szLog,strlen(szLog), LOG_ERR);
}
}
return bResult;
}
Bool CollectMsg(const char *szColumnName, char*szBuff, int nBuffSize)
{
bool bResult = false;
if (adStateClosed !=m_pRecord->State) {
try{
_variant_t Column(szColumnName);
_variant_t RusultGet= m_pRecord->Fields->GetItem(Column)->Value;
WideCharToMultiByte(CP_ACP,0, RusultGet.bstrVal, -1, szBuff, nBuffSize,
NULL, NULL);
bResult = true;
}
catch(_com_error e){
charszLog[MAX_BUFF]; memset(szLog, 0, MAX_BUFF);
sprintf(szLog,"%s", (char *)(e.Description()));
m_WriteLog.WriteLog(szLog,strlen(szLog), LOG_ERR);
}
}
return bResult;
}
Bool RecordMoveNext()
{
bool bResult = false;
if (NULL != m_pRecord) {
if (!m_pRecord->adoEOF) {
try{
m_pRecord->MoveNext();
bResult =true;
}
catch(_com_error e){
charszLog[MAX_BUFF]; memset(szLog, 0, MAX_BUFF);
sprintf(szLog,"RecordMoveNext错误:%s\n", (char *)(e.Description()));
m_WriteLog.WriteLog(szLog,strlen(szLog), LOG_ERR);
}
}
}
return bResult;
}
Void CloseRecord (void){
try{
if (NULL != m_pRecord){
m_pRecord->Close();
m_pRecord = NULL;
}
}
catch(_com_error e){
char szLog[MAX_BUFF];memset(szLog, 0, MAX_BUFF);
sprintf(szLog, "关闭数据记录集错误:%s\n",(char *)(e.Description()));
m_WriteLog.WriteLog(szLog,strlen(szLog), LOG_ERR);
}
}
3.4执行SQL命令
可通过Command对象来执行命令，也可以直接通过Connection对象来执行，以下介绍通过Connection对象来执行命令，命令可以是Updata命令，Insert命令等，以下是代码：
//第一个参数是要执行的命令，第二个参数用来返回影响的行数
Bool ExecuteSQL(const char *szSQLStr, long&nRefreshNum){
bool bResult = false;
if (strlen(szSQLStr) > 0) {
if (NULL == m_pConn ||adStateClosed == m_pConn->State)
ConnDB();
try
{
_variant_tRefreshNum;
m_pConn->Execute(_bstr_t(szSQLStr),&RefreshNum, adCmdText);
bResult = true;
nRefreshNum =RefreshNum.lVal;
}
catch (_com_error e)
{
nRefreshNum = 0;
charszLog[MAX_BUFF]; memset(szLog, 0, MAX_BUFF);
sprintf(szLog,"执行SQL命令错误:%s[%s]", (char *)(e.Description()), szSQLStr);
m_WriteLog.WriteLog(szLog,strlen(szLog), LOG_ERR);
}
}
return bResult;
}
3.5关闭连接、记录集
连接对象与记录集使用完之后，要关闭：
if (NULL !=m_pConn)
m_pConn->Close();
if (NULL !=m_pRecord){
m_pRecord->Close();