VisualC++ADO数据库编程入门
一、在VC++中使用ADO编程
ADO实际上就是由一组Automation对象构成的组件，因此可以象使用其它任何Automation对象一样使用ADO。ADO中最重要的对象有三个：Connection、Command和Recordset，它们分别表示连接对象、命令对象和记录集对象。如果您熟悉使用MFC中的ODBC类（CDatabase、CRecordset)编程，那么学习ADO编程就十分容易了。
使用ADO编程时可以采用以下三种方法之一：
1、使用预处理指令#import
#import"C:ProgramFilesCommonFilesSystemADOmsado15.dll"
no_namespacerename("EOF","EndOfFile") |
但要注意不能放在stdAfx.h文件的开头，而应该放在所有include指令的后面。否则在编译时会出错。
程序在编译过程中，VC++会读出msado15.dll中的类型库信息，自动产生两个该类型库的头文件和实现文件msado15.tlh和msado15.tli（在您的Debug或Release目录下）。在这两个文件里定义了ADO的所有对象和方法，以及一些枚举型的常量等。我们的程序只要直接调用这些方法就行了，与使用MFC中的COleDispatchDriver类调用Automation对象十分类似。
2、使用MFC中的CIDispatchDriver
就是通过读取msado15.dll中的类型库信息，建立一个COleDispatchDriver类的派生类，然后通过它调用ADO对象。
3、直接用COM提供的API
如使用如下代码：
CLSIDclsid;
HRESULThr=::CLSIDFromProgID(L"ADODB.Connection",&clsid);
if(FAILED(hr))
{...}
::CoCreateInstance(clsid,NULL,CLSCTX_SERVER,IID_IDispatch,(void**)
&pDispatch);
if(FAILED(hr))
{...} |
以上三种方法，第一和第二种类似，可能第一种好用一些，第三种编程可能最麻烦。但可能第三种方法也是效率最高的，程序的尺寸也最小，并且对ADO的控制能力也最强。
据微软资料介绍，第一种方法不支持方法调用中的默认参数，当然第二种方法也是这样，但第三种就不是这样了。采用第三种方法的水平也最高。当你需要绕过ADO而直接调用OLEDB底层的方法时，就一定要使用第三种方法了。
ADO编程的关键，就是熟练地运用ADO提供的各种对象(object)、方法(method)、属性(property)和容器（collection）。另外，如果是在MSSQL或Oracle等大型数据库上编程，还要能熟练使用SQL语言。
二、使用#import方法的编程步骤
这里建议您使用#import的方法，因为它易学、易用，代码也比较简洁。
1、添加#import指令
打开stdafx.h文件，将下列内容添加到所有的include指令之后：
#include<icrsint.h>//IncludesupportforVC++Extensions
#import"C:ProgramFilesCommonFilesSystemADOmsado15.dll"
no_namespacerename("EOF","adoEOF") |
其中icrsint.h文件包含了VC++扩展的一些预处理指令、宏等的定义，用于COM编程时使用。
2、定义_ConnectionPtr型变量，并建立数据库连接
建立了与数据库服务器的连接后，才能进行其他有关数据库的访问和操作。ADO使用Connection对象来建立与数据库服务器的连接，所以它相当于MFC中的CDatabase类。和CDatabase类一样，调用Connection对象的Open方法即可建立与服务器的连接。
数据类型_ConnectionPtr实际上就是由类模板_com_ptr_t而得到的一个具体的实例类，其定义可以到msado15.tlh、comdef.h和comip.h这三个文件中找到。在msado15.tlh中有：
_COM_SMARTPTR_TYPEDEF(_Collection,__uuidof(_Collection)); |
经宏扩展后就得到了_ConnectionPtr类。_ConnectionPtr类封装了Connection对象的Idispatch接口指针，及一些必要的操作。我们就是通过这个指针来操纵Connection对象。类似地，后面用到的_CommandPtr和_RecordsetPtr类型也是这样得到的，它们分别表示命令对象指针和记录集对象的指针。
（1）、连接到MSSQLServer
注意连接字符串的格式，提供正确的连接字符串是成功连接到数据库服务器的第一步，有关连接字符串的详细信息参见微软MSDNLibrary光盘。
本例连接字符串中的server_name，database_name，user_name和password在编程时都应该替换成实际的内容。
_ConnectionPtrpMyConnect=NULL;
HRESULThr=pMyConnect.CreateInstance(__uuidof(Connection)));
if(FAILED(hr))return;
_bstr_tstrConnect="Provider=SQLOLEDB;Server=server_name;"
"Database=database_name;uid=user_name;pwd=password;";
//connectingtothedatabaseservernow:
try{pMyConnect->Open(strConnect,"","",NULL);}
catch(_com_error&e)
{
::MessageBox(NULL,e.Description(),"警告",MB_OK│MB_ICONWARNING);
} |
注意Connection对象的Open方法中的连接字符串参数必须是BSTR或_bstr_t类型。另外，本例是直接通过OLEDBProvider建立连接，所以无需建立数据源。
（2）、通过ODBCDriver连接到DatabaseServer连接字符串格式与直接用ODBC编程时的差不多：
_bstr_tstrConnect="DSN=datasource_name;Database=database_name;uid=user_name;pwd=password;"; |
此时与ODBC编程一样，必须先建立数据源。
3、定义_RecordsetPtr型变量，并打开数据集
定义_RecordsetPtr型变量，然后通过它调用Recordset对象的Open方法，即可打开一个数据集。所以Recordset对象与MFC中的CRecordset类类似，它也有当前记录、当前记录指针的概念。如：
_RecordsetPtrm_pRecordset;
if(!FAILED(m_pRecordset.CreateInstance(__uuidof(Recordset)))
{
m_pDoc->m_initialized=FALSE;
return;
}
try{
m_pRecordset->Open(_variant_t("mytable"),
_variant_t((IDispatch*)pMyConnect,true),adOpenKeyset,
adLockOptimistic,adCmdTable);
}
catch(_com_error&e)
{
::MessageBox(NULL,"无法打开mytable表。","提示",
MB_OK│MB_ICONWARNING);
} |
Recordset对象的Open方法非常重要，它的第一个参数可以是一个SQL语句、一个表的名字或一个命令对象等等；第二个参数就是前面建立的连接对象的指针。此外，用Connection和Command对象的Execute方法也能得到记录集，但是只读的。
4、读取当前记录的数据
我认为读取数据的最方便的方法如下：
try{
m_pRecordset->MoveFirst();
while(m_pRecordset->adoEOF==VARIANT_FALSE)
{
//Retrievecolumn'svalue:
CStringsName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t("name"))->Value);
shortcAge=(short)(m_pRecordset->Fields->GetItem
(_variant_t("age"))->Value);
//Dosomethingwhatyouwanttodo:
......
m_pRecordset->MoveNext();
}
}//try
catch(_com_error&e)
{
CStringstr=(char*)e.Description();
::MessageBox(NULL,str+"n又出毛病了。","提示",
MB_OK│MB_ICONWARNING);
} |
本例中的name和age都是字段名，读取的字段值分别保存在sName和cAge变量内。例中的Fields是Recordset对象的容器，GetItem方法返回的是Field对象，而Value则是Field对象的一个属性（即该字段的值）。通过此例，应掌握操纵对象属性的方法。例如，要获得Field对象的Value属性的值可以直接用属性名Value来引用它（如上例），但也可以调用Get方法，例如：
CStringsName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t("name"))->GetValue()); |
从此例还可以看到，判断是否到达记录集的末尾，使用记录集的adoEOF属性，其值若为真即到了结尾，反之则未到。判断是否到达记录集开头，则可用BOF属性。
另外，读取数据还有一个方法，就是定义一个绑定的类，然后通过绑定的变量得到字段值（详见后面的介绍）。
5、修改数据
方法一：
try{
m_pRecordset->MoveFirst();
while(m_pRecordset->adoEOF==VARIANT_FALSE)
{
m_pRecordset->Fields->GetItem
(_variant_t("姓名"))->Value=_bstr_t("赵薇");
......
m_pRecordset->Update();
m_pRecordset->MoveNext();
}
}//try |
改变了Value属性的值，即改变了字段的值。
方法二：
m_pRecordset->Fields->GetItem
(_variant_t("姓名"))->PutValue(_bstr_t("赵薇")); |
方法三：就是用定义绑定类的方法（详见后面的介绍）。
6、添加记录
新记录添加成功后，即自动成为当前记录。AddNew方法有两种形式，一个含有参数，而另一个则不带参数。
方法一（不带参数）：
//Addnewrecordintothistable:
try{
if(!m_pRecordset->Supports(adAddNew))return;
m_pRecordset->AddNew();
m_pRecordset->Fields->GetItem
(_variant_t("姓名"))->Value=_bstr_t("赵薇");
m_pRecordset->Fields->GetItem
(_variant_t("性别"))->Value=_bstr_t("女");
m_pRecordset->Fields->GetItem
(_variant_t("age"))->Value=_variant_t((short)20);
m_pRecordset->Fields->GetItem
(_variant_t("marry"))->Value=_bstr_t("未婚");
m_pRecordset->Update();
}//try
catch(_com_error&e)
{
::MessageBox(NULL,"又出毛病了。","提示",MB_OK│MB_ICONWARNING);
} |
这种方法弄完了还要调用Update()。
方法二（带参数）：
_variant_tvarName[4],narValue[4];
varName[0]=L"姓名";
varName[1]=L"性别";
varName[2]=L"age";
varName[3]=L"marry";
narValue[0]=_bstr_t("赵薇");
narValue[1]=_bstr_t("女");
narValue[2]=_variant_t((short)20);
narValue[3]=_bstr_t("未婚");
constintnCrit=sizeofvarName/sizeofvarName[0];
//CreateSafeArrayBoundsandinitializethearray
SAFEARRAYBOUNDrgsaName[1],rgsaValue[1];
rgsaName[0].lLbound=0;
rgsaName[0].cElements=nCrit;
SAFEARRAY*psaName=SafeArrayCreate(VT_VARIANT,1,rgsaName);
rgsaValue[0].lLbound=0;
rgsaValue[0].cElements=nCrit;
SAFEARRAY*psaValue=SafeArrayCreate(VT_VARIANT,1,rgsaValue);
//Setthevaluesforeachelementofthearray
HRESULThr1=S_OK.hr2=S_OK;
for(longi=0;i<nCrit&&SUCCEEDED(hr1)&&SUCCEEDED(hr2);i++)
{
hr1=SafeArrayPutElement(psaName,&i,&varName[i]);
hr2=SafeArrayPutElement(psaValue,&i,&narValue[i]);}
//InitializeandfilltheSafeArray
VARIANTvsaName,vsaValue;
vsaName.vt=VT_VARIANT│VT_ARRAY;
vsaValue.vt=VT_VARIANT│VT_ARRAY;
V_ARRAY(&vsaName)=psaName;//&vsaName->parray=psaName;
//seedefinitioninoleauto.hfile.
V_ARRAY(&vsaValue)=psaValue;
//Addanewrecord:
m_pRecordset->AddNew(vsaName,vsaValue); |
这种方法不需要调用Update，因为添加后，ADO会自动调用它。此方法主要是使用SafeArray挺麻烦。
方法三：就是用定义绑定类的方法（详见后面的介绍）。
7、删除记录
调用Recordset的Delete方法就行了，删除的是当前记录。要了解Delete的其它用法请查阅参考文献。
try{
m_pRecordset->MoveFirst();
while(m_pRecordset->adoEOF==VARIANT_FALSE)
{
CStringsName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t("姓名"))->Value);
if(::MessageBox(NULL,"姓名="+sName+"n删除她吗？",
"提示",MB_YESNO│MB_ICONWARNING)==IDYES)
{
m_pRecordset->Delete(adAffectCurrent);
m_pRecordset->Update();
}
m_pRecordset->MoveNext();
}
}//try
catch(_com_error&e)
{
::MessageBox(NULL,"又出毛病了。","提示",MB_OK│MB_ICONWARNING);
} |
8、使用带参数的命令
Command对象所代表的就是一个Provider能够理解的命令，如SQL语句等。使用Command对象的关键就是把表示命令的语句设置到CommandText属性中，然后调用Command对象的Execute方法就行了。一般情况下在命令中无需使用参数，但有时使用参数，可以增加其灵活性和效率。
(1).建立连接、命令对象和记录集对象
本例中表示命令的语句就是一个SQL语句（SELECT语句）。SELECT语句中的问号?就代表参数，如果要多个参数，就多放几个问号，每个问号代表一个参数。
_ConnectionPtrConn1;
_CommandPtrCmd1;
ParametersPtr*Params1=NULL;//Notaninstanceofasmartpointer.
_ParameterPtrParam1;
_RecordsetPtrRs1;
try
{
//CreateConnectionObject(1.5Version)
Conn1.CreateInstance(__uuidof(Connection));
Conn1->ConnectionString=bstrConnect;
Conn1->Open(bstrEmpty,bstrEmpty,bstrEmpty,-1);
//CreateCommandObject
Cmd1.CreateInstance(__uuidof(Command));
Cmd1->ActiveConnection=Conn1;
Cmd1->CommandText=_bstr_t("SELECT*FROMmytableWHEREage<?");
}//try |
要注意命令对象必须与连接对象关联起来才能起作用，本例中将命令对象的ActiveConnection属性设置为连接对象的指针，即为此目的：
Cmd1->ActiveConnection=Conn1; |
(2).创建参数对象，并给参数赋值
//CreateParameterObject
Param1=Cmd1->CreateParameter(_bstr_t(bstrEmpty),
adInteger,
adParamInput,
-1,
_variant_t((long)5));
Param1->Value=_variant_t((long)5);
Cmd1->Parameters->Append(Param1); |
用命令对象的方法来创建一个参数对象，其中的长度参数（第三个）如果是固定长度的类型，就填-1，如果是字符串等可变长度的就填其实际长度。Parameters是命令对象的一个容器，它的Append方法就是把创建的参数对象追加到该容器里。Append进去的参数按先后顺序与SQL语句中的问号从左至右一一对应。
(3).执行命令打开记录集
//OpenRecordsetObject
Rs1=Cmd1->Execute(&vtEmpty,&vtEmpty2,adCmdText); |
但要注意，用Command和Connection对象的Execute方法得到的Recordset是只读的。因为在打开Recordset之前，我们无法设置它的LockType属性（其默认值为只读）。而在打开之后设置LockType不起作用。
我发现用上述方法得到记录集Rs1后，不但Rs1中的记录无法修改，即使直接用SQL语句修改同一表中任何记录都不行。
要想能修改数据，还是要用Recordset自己的Open方法才行，如：
try{
m_pRecordset->Open((IDispatch*)Cmd1,vtMissing,
adOpenStatic,adLockOptimistic,adCmdUnspecified);
}
catch(_com_error&e)
{
::MessageBox(NULL,"mytable表不存在。","提示",MB_OK│MB_ICONWARNING);
} |
Recordset对象的Open方法真是太好了，其第一个参数可以是SQL语句、表名字、命令对象指针等等。
9、响应ADO的通知事件
通知事件就是当某个特定事件发生时，由Provider通知客户程序，换句话说，就是由Provider调用客户程序中的一个特定的方法（即事件的处理函数）。所以为了响应一个事件，最关键的就是要实现事件的处理函数。
(1).从ConnectionEventsVt接口派生出一个类
为了响应_Connection的通知事件，应该从ConnectionEventsVt接口派生出一个类：
classCConnEvent:publicConnectionEventsVt
{
private:
ULONGm_cRef;
public:
CConnEvent(){m_cRef=0;};
~CConnEvent(){};
STDMETHODIMPQueryInterface(REFIIDriid,void**ppv);
STDMETHODIMP_(ULONG)AddRef(void);
STDMETHODIMP_(ULONG)Release(void);
STDMETHODIMPraw_InfoMessage(
structError*pError,
EventStatusEnum*adStatus,
struct_Connection*pConnection);
STDMETHODIMPraw_BeginTransComplete(
LONGTransactionLevel,
structError*pError,
EventStatusEnum*adStatus,
struct_Connection*pConnection);
......
}; |
(2).实现每一个事件的处理函数(凡是带raw_前缀的方法都把它实现了)：
STDMETHODIMPCConnEvent::raw_InfoMessage(
structError*pError,
EventStatusEnum*adStatus,
struct_Connection*pConnection)
{
*adStatus=adStatusUnwantedEvent;
returnS_OK;
}; |
有些方法虽然你并不需要，但也必须实现它，只需简单地返回一个S_OK即可。但如果要避免经常被调用，还应在其中将adStatus参数设置为adStatusUnwantedEvent，则在本次调用后，以后就不会被调用了。
另外还必须实现QueryInterface,AddRef,和Release三个方法:
STDMETHODIMPCConnEvent::QueryInterface(REFIIDriid,void**ppv)
{
*ppv=NULL;
if(riid==__uuidof(IUnknown)││
riid==__uuidof(ConnectionEventsVt))*ppv=this;
if(*ppv==NULL)
returnResultFromScode(E_NOINTERFACE);
AddRef();
returnNOERROR;
}
STDMETHODIMP_(ULONG)CConnEvent::AddRef(){return++m_cRef;};
STDMETHODIMP_(ULONG)CConnEvent::Release()
{
if(0!=--m_cRef)returnm_cRef;
deletethis;
return0;
} |
(3).开始响应通知事件
//StartusingtheConnectionevents
IConnectionPointContainer*pCPC=NULL;
IConnectionPoint*pCP=NULL;
hr=pConn.CreateInstance(__uuidof(Connection));
if(FAILED(hr))return;
hr=pConn->QueryInterface(__uuidof(IConnectionPointContainer),
(void**)&pCPC);
if(FAILED(hr))return;
hr=pCPC->FindConnectionPoint(__uuidof(ConnectionEvents),&pCP);
pCPC->Release();
if(FAILED(hr))return;
pConnEvent=newCConnEvent();
hr=pConnEvent->QueryInterface(__uuidof(IUnknown),(void**)&pUnk);
if(FAILED(hr))returnrc;
hr=pCP->Advise(pUnk,&dwConnEvt);
pCP->Release();
if(FAILED(hr))return;
pConn->Open("dsn=Pubs;","sa","",adConnectUnspecified); |
也就是说在连接(Open)之前就做这些事。
(4).停止响应通知事件
pConn->Close();
//StopusingtheConnectionevents
hr=pConn->QueryInterface(__uuidof(IConnectionPointContainer),
(void**)&pCPC);
if(FAILED(hr))return;
hr=pCPC->FindConnectionPoint(__uuidof(ConnectionEvents),&pCP);
pCPC->Release();
if(FAILED(hr))returnrc;
hr=pCP->Unadvise(dwConnEvt);
pCP->Release();
if(FAILED(hr))return; |
在连接关闭之后做这件事。
10、邦定数据
定义一个绑定类，将其成员变量绑定到一个指定的记录集，以方便于访问记录集的字段值。
(1).从CADORecordBinding派生出一个类：
classCCustomRs:publicCADORecordBinding
{
BEGIN_ADO_BINDING(CCustomRs)
ADO_VARIABLE_LENGTH_ENTRY2(3,adVarChar,m_szau_fname,
sizeof(m_szau_fname),lau_fnameStatus,false)
ADO_VARIABLE_LENGTH_ENTRY2(2,adVarChar,m_szau_lname,
sizeof(m_szau_lname),lau_lnameStatus,false)
ADO_VARIABLE_LENGTH_ENTRY2(4,adVarChar,m_szphone,
sizeof(m_szphone),lphoneStatus,true)
END_ADO_BINDING()
public:
CHARm_szau_fname[22];
ULONGlau_fnameStatus;
CHARm_szau_lname[42];
ULONGlau_lnameStatus;
CHARm_szphone[14];
ULONGlphoneStatus;
}; |
其中将要绑定的字段与变量名用BEGIN_ADO_BINDING宏关联起来。每个字段对应于两个变量，一个存放字段的值，另一个存放字段的状态。字段用从1开始的序号表示，如1，2，3等等。
特别要注意的是：如果要绑定的字段是字符串类型，则对应的字符数组的元素个数一定要比字段长度大2（比如m_szau_fname[22]，其绑定的字段au_fname的长度实际是20），不这样绑定就会失败。我分析多出的2可能是为了存放字符串结尾的空字符null和BSTR字符串开头的一个字（表示BSTR的长度）。这个问题对于初学者来说可能是一个意想不到的问题。
CADORecordBinding类的定义在icrsint.h文件里，内容是：
classCADORecordBinding
{
public:
STDMETHOD_(constADO_BINDING_ENTRY*,GetADOBindingEntries)(VOID)PURE;
};
BEGIN_ADO_BINDING宏的定义也在icrsint.h文件里，内容是：
#defineBEGIN_ADO_BINDING(cls)public:
typedefclsADORowClass;
constADO_BINDING_ENTRY*STDMETHODCALLTYPEGetADOBindingEntries(){
staticconstADO_BINDING_ENTRYrgADOBindingEntries[]={
ADO_VARIABLE_LENGTH_ENTRY2宏的定义也在icrsint.h文件里：
#defineADO_VARIABLE_LENGTH_ENTRY2(Ordinal,DataType,Buffer,Size,Status,Modify)
{Ordinal,
DataType,
0,
0,
Size,
offsetof(ADORowClass,Buffer),
offsetof(ADORowClass,Status),
0,
classoffset(CADORecordBinding,ADORowClass),
Modify},
#defineEND_ADO_BINDING宏的定义也在icrsint.h文件里：
#defineEND_ADO_BINDING(){0,adEmpty,0,0,0,0,0,0,0,FALSE}};
returnrgADOBindingEntries;} |
(2).绑定
_RecordsetPtrRs1;
IADORecordBinding*picRs=NULL;
CCustomRsrs;
......
Rs1->QueryInterface(__uuidof(IADORecordBinding),
(LPVOID*)&picRs));
picRs->BindToRecordset(&rs); |
派生出的类必须通过IADORecordBinding接口才能绑定，调用它的BindToRecordset方法就行了。
(3).rs中的变量即是当前记录字段的值
//Setsortandfiltercondition:
//Step4:Manipulatethedata
Rs1->Fields->GetItem("au_lname")->Properties->GetItem("Optimize")->Value=true;
Rs1->Sort="au_lnameASC";
Rs1->Filter="phoneLIKE'4155*'";
Rs1->MoveFirst();
while(VARIANT_FALSE==Rs1->EndOfFile)
{
printf("Name:%st%stPhone:%sn",
(rs.lau_fnameStatus==adFldOK?rs.m_szau_fname:""),
(rs.lau_lnameStatus==adFldOK?rs.m_szau_lname:""),
(rs.lphoneStatus==adFldOK?rs.m_szphone:""));
if(rs.lphoneStatus==adFldOK)
strcpy(rs.m_szphone,"777");
TESTHR(picRs->Update(&rs));//Addchangetothebatch
Rs1->MoveNext();
}
Rs1->Filter=(long)adFilterNone;
......
if(picRs)picRs->Release();
Rs1->Close();
pConn->Close(); |
只要字段的状态是adFldOK，就可以访问。如果修改了字段，不要忘了先调用picRs的Update（注意不是Recordset的Update），然后才关闭，也不要忘了释放picRs（即picRs->Release();）。
(4).此时还可以用IADORecordBinding接口添加新纪录
if(FAILED(picRs->AddNew(&rs)))
...... |
爱华网本文地址 » http://www.413yy.cn/a/25101015/248878.html
爱华网
