http://dev.gameres.com/Program/Control/ADOData.htm
ADO数据库编程入门 |
文档简介: 本文简要介绍了在VC++ 6.0中使用 ADO进行客户端数据库编程的基本步骤,以及常见问题的解决方法,可供入门级的参考之用。 关键字: ADO VC++ 数据库编程 目录: 文档内容: ADO是目前在Windows环境中比较流行的客户端数据库编程技术。ADO是建立在OLE DB底层技术之上的高级编程接口,因而它兼具有强大的数据处理功能(处理各种不同类型的数据源、分布式的数据处理等等)和极其简单、易用的编程接口,因而得到了广泛的应用。而且按微软公司的意图,OLE DB和ADO将逐步取代 ODBC和DAO。现在介绍ADO各种应用的文章和书籍有很多,本文着重站在初学者的角度,简要探讨一下在VC++中使用ADO编程时的一些问题。我们希望阅读本文之前,您对ADO技术的基本原理有一些了解。 一、在VC++中使用ADO编程 1、使用预处理指令#import no_namespace rename("EOF", "EndOfFile") 但要注意不能放在stdAfx.h文件的开头,而应该放在所有include指令的后面。否则在编译时会出错。 程序在编译过程中,VC++会读出msado15.dll中的类型库信息,自动产生两个该类型库的头文件和实现文件msado15.tlh和msado15.tli(在您的Debug或Release目录下)。在这两个文件里定义了ADO的所有对象和方法,以及一些枚举型的常量等。我们的程序只要直接调用这些方法就行了,与使用MFC中的COleDispatchDriver类调用Automation对象十分类似。 2、使用MFC中的CIDispatchDriver 3、直接用COM提供的API HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid); if(FAILED(hr)) {...} ::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)&pDispatch); if(FAILED(hr)) {...} 以上三种方法,第一和第二种类似,可能第一种好用一些,第三种编程可能最麻烦。但可能第三种方法也是效率最高的,程序的尺寸也最小,并且对ADO的控制能力也最强。 二、使用#import方法的编程步骤 1、 添加#import指令 2、定义_ConnectionPtr型变量,并建立数据库连接 _COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection)); 经宏扩展后就得到了_ConnectionPtr类。_ConnectionPtr类封装了Connection对象的Idispatch接口指针,及一些必要的操作。我们就是通过这个指针来操纵Connection对象。类似地,后面用到的_CommandPtr和_RecordsetPtr类型也是这样得到的,它们分别表示命令对象指针和记录集对象的指针。 (1)、连接到MS SQL Server HRESULT hr = pMyConnect.CreateInstance(__uuidof(Connection))); if( FAILED(hr) ) _bstr_t strConnect="Provider=SQLOLEDB; Server=server_name;" //connecting to the database server now: catch (_com_error &e) 注意Connection对象的Open方法中的连接字符串参数必须是BSTR或_bstr_t类型。另外,本例是直接通过OLE DB Provider建立连接,所以无需建立数据源。 (2)、通过ODBC Driver连接到Database Server 此时与ODBC编程一样,必须先建立数据源。 3、定义_RecordsetPtr型变量,并打开数据集 if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset ))) { m_pDoc->m_initialized=FALSE; return; } try Recordset对象的Open方法非常重要,它的第一个参数可以是一个SQL语句、一个表的名字或一个命令对象等等;第二个参数就是前面建立的连接对象的指针。此外,用Connection和Command对象的Execute方法也能得到记录集,但是只读的。 4、读取当前记录的数据 { m_pRecordset->MoveFirst(); while(m_pRecordset->adoEOF==VARIANT_FALSE) { //Retrieve column's value: CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem(_variant_t("name"))->Value); short cAge=(short)(m_pRecordset->Fields->GetItem(_variant_t("age"))->Value); //Do something what you want to do: ...... m_pRecordset->MoveNext(); } }//try catch (_com_error &e) { CString str=(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方法,例如: CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem(_variant_t("name"))->GetValue());从此例还可以看到,判断是否到达记录集的末尾,使用记录集的adoEOF属性,其值若为真即到了结尾,反之则未到。判断是否到达记录集开头,则可用BOF属性。 5、修改数据 { 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、添加记录 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()。 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("未婚"); const int nCrit = sizeof varName / sizeof varName[0]; // Create SafeArray Bounds and initialize the array // Set the values for each element of the array for( long i = 0 ; i < nCrit && SUCCEEDED( hr1 ) && SUCCEEDED( hr2 );i++) 这种方法不需要调用Update,因为添加后,ADO会自动调用它。此方法主要是使用SafeArray挺麻烦。 方法三:就是用定义绑定类的方法(详见后面的介绍)。 7、删除记录 { m_pRecordset->MoveFirst(); while(m_pRecordset->adoEOF==VARIANT_FALSE) { CString sName=(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). 建立连接、命令对象和记录集对象 _CommandPtr Cmd1; ParametersPtr *Params1 = NULL; // Not an instance of a smart pointer. _ParameterPtr Param1; _RecordsetPtr Rs1; try // Create Command Object 要注意命令对象必须与连接对象关联起来才能起作用,本例中将命令对象的ActiveConnection属性设置为连接对象的指针,即为此目的: Cmd1->ActiveConnection = Conn1; (2). 创建参数对象,并给参数赋值 // Create Parameter ObjectParam1 = 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). 执行命令打开记录集 // Open Recordset ObjectRs1 = Cmd1->Execute( &vtEmpty, &vtEmpty2, adCmdText ); 但要注意,用Command和Connection对象的Execute方法得到的Recordset是只读的。因为在打开Recordset之前,我们无法设置它的LockType属性(其默认值为只读)。而在打开之后设置LockType不起作用。 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的通知事件 (1). 从ConnectionEventsVt接口派生出一个类 { private: ULONG m_cRef; public: STDMETHODIMP QueryInterface(REFIID riid, void ** ppv); (2). 实现每一个事件的处理函数(凡是带raw_前缀的方法都把它实现了): STDMETHODIMP CConnEvent::raw_InfoMessage( struct Error *pError, EventStatusEnum *adStatus, struct _Connection *pConnection){ *adStatus = adStatusUnwantedEvent; return S_OK; }; 有些方法虽然你并不需要,但也必须实现它,只需简单地返回一个S_OK即可。但如果要避免经常被调用,还应在其中将adStatus参数设置为adStatusUnwantedEvent,则在本次调用后,以后就不会被调用了。 { *ppv = NULL; if (riid == __uuidof(IUnknown) || riid == __uuidof(ConnectionEventsVt)) *ppv = this; if (*ppv == NULL) AddRef(); STDMETHODIMP_(ULONG) CConnEvent::AddRef() { return ++m_cRef; }; STDMETHODIMP_(ULONG) CConnEvent::Release() delete this; (3). 开始响应通知事件 // Start using the Connection eventsIConnectionPointContainer *pCPC = NULL; IConnectionPoint *pCP = NULL; hr = pConn.CreateInstance(__uuidof(Connection)); if (FAILED(hr)) return; hr = pConn->QueryInterface(__uuidof(IConnectionPointContainer), (void **)&pCPC); hr = pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP); pConnEvent = new CConnEvent(); hr = pCP->Advise(pUnk, &dwConnEvt); pConn->Open("dsn=Pubs;", "sa", "", adConnectUnspecified); 也就是说在连接(Open)之前就做这些事。 (4). 停止响应通知事件 pConn->Close();// Stop using the Connection events hr = pConn->QueryInterface(__uuidof(IConnectionPointContainer), (void **) &pCPC); if (FAILED(hr)) return; hr = pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP); hr = pCP->Unadvise( dwConnEvt ); 在连接关闭之后做这件事。 10、邦定数据 (1). 从CADORecordBinding派生出一个类: class CCustomRs : public CADORecordBinding{ 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: 其中将要绑定的字段与变量名用BEGIN_ADO_BINDING宏关联起来。每个字段对应于两个变量,一个存放字段的值,另一个存放字段的状态。字段用从1开始的序号表示,如1,2,3等等。 { public: STDMETHOD_(const ADO_BINDING_ENTRY*, GetADOBindingEntries) (VOID) PURE; }; BEGIN_ADO_BINDING宏的定义也在icrsint.h文件里,内容是: #define BEGIN_ADO_BINDING(cls) public: \ (2). 绑定 _RecordsetPtr Rs1;IADORecordBinding *picRs=NULL; CCustomRs rs; ...... Rs1->QueryInterface(__uuidof(IADORecordBinding), (LPVOID*)&picRs)); picRs->BindToRecordset(&rs); 派生出的类必须通过IADORecordBinding接口才能绑定,调用它的BindToRecordset方法就行了。 (3). rs中的变量即是当前记录字段的值 //Set sort and filter condition:// Step 4: Manipulate the data Rs1->Fields->GetItem("au_lname")->Properties->GetItem("Optimize")->Value = true; Rs1->Sort = "au_lname ASC"; Rs1->Filter = "phone LIKE '415 5*'"; Rs1->MoveFirst(); while (VARIANT_FALSE == Rs1->EndOfFile) { printf("Name: %s\t %s\tPhone: %s\n", (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) TESTHR(picRs->Update(&rs)); // Add change to the batch 只要字段的状态是adFldOK,就可以访问。如果修改了字段,不要忘了先调用picRs的Update(注意不是Recordset的Update),然后才关闭,也不要忘了释放picRs(即picRs->Release();)。 (4). 此时还可以用IADORecordBinding接口添加新纪录 if(FAILED(picRs->AddNew(&rs)))...... 11. 访问长数据 SAFEARRAY *psa; SAFEARRAYBOUND rgsabound[1]; //VT_ARRAY | VT_UI1 CFile f("h:\\aaa.jpg",CFile::modeRead); //Create a safe array to store the array of BYTES for(long index=0;index<uIsRead;index++) varChunk.vt = VT_ARRAY|VT_UI1; ::VariantClear(&varChunk); f.Close(); //从数据库读一张照片: while(lPhotoSize>0) for(long index=0;index<lIsRead;index++) f.Close(); 12. 使用SafeArray问题 方法一: (1). 定义变量,如: SAFEARRAY *psa; SAFEARRAYBOUND rgsabound[1]; (2). 创建SafeArray描述符: uIsRead=f.Read(bVal,ChunkSize);//read array from a file. if(uIsRead==0) break; rgsabound[0].cElements =uIsRead; rgsabound[0].lLbound = 0; psa = SafeArrayCreate(VT_UI1,1,rgsabound); (3). 放置数据元素到SafeArray: for(long index=0;index<uIsRead;index++) { if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index]))) ::MessageBox(NULL,"出毛病了。","提示",MB_OK | MB_ICONWARNING); } 一个一个地放,挺麻烦的。 (4). 封装到VARIANT内: varChunk.parray = psa; 这样就可以将varChunk作为参数传送出去了。 读取SafeArray中的数据的步骤: (1). 用SafeArrayGetElement一个一个地读 BYTE buf[lIsRead];for(long index=0;index<lIsRead;index++) { ::SafeArrayGetElement(varChunk.parray,&index,buf+index); } 就读到缓冲区buf里了。 方法二: (1). 读缓冲区: SafeArrayAccessData(varChunk.parray, (void **)&buf); f.Write(buf,lIsRead); SafeArrayUnaccessData(varChunk.parray); (2). 写缓冲区: ::SafeArrayAccessData(psa, (void **)&buf); for(long index=0;index<uIsRead;index++) { buf[index]=bVal[index]; } ::SafeArrayUnaccessData(psa); varChunk.vt = VT_ARRAY|VT_UI1; varChunk.parray = psa; 这种方法读写SafeArray都可以,它直接操纵SafeArray的数据缓冲区,比用SafeArrayGetElement和SafeArrayPutElement速度快。特别适合于读取数据。但用完之后不要忘了调用::SafeArrayUnaccessData(psa),否则会出错的。 13. 使用书签( bookmark ) (1). 建立一个VARIANT类型的变量 (2). 将当前记录的书签值存入该变量 (3). 返回到先前的记录 if (VarBookmark.vt == VT_EMPTY) printf("No Bookmark set!\n"); else rst->Bookmark = VarBookmark; 设置完后,当前记录即会移动到该书签指向的记录。 14、设置过滤条件 (1)、可以用圆括号组成复杂的表达式 但是微软不允许在括号内用OR,然后在括号外用AND,例如: rst->Filter = _bstr_t ("(姓名='赵薇' OR 性别=’女’) AND AGE<25"); 必须修改为: rst->Filter = _bstr_t ("(姓名='赵薇' AND AGE<25) OR (性别=’女’ AND AGE<25)"); (2)、表达式中的比较运算符可以是LIKE 也可以只是尾部带星号: rst->Filter = _bstr_t ("姓名 LIKE '赵*' "); Filter属性值的类型是Variant,如果过滤条件是由书签组成的数组,则需将该数组转换为SafeArray,然后再封装到一个VARIANT或_variant_t型的变量中,再赋给Filter属性。 15、索引与排序 (1)、建立索引 pRst->Find("姓名 = '赵薇'",1,adSearchForward); ...... pRst->Fields->GetItem("姓名")->Properties->GetItem("Optimize")->PutValue("False"); pRst->Close(); 说明:Optimize属性是由Provider提供的属性(在ADO中称为动态属性),ADO本身没有此属性。 (2)、排序 pRstAuthors->Open("SELECT * FROM mytable", _variant_t((IDispatch *) pConnection), adOpenStatic, adLockReadOnly, adCmdText); ...... pRst->Sort = "姓名 DESC, 年龄 ASC"; 关键字(即字段名)之间用逗号隔开,如果要以某关键字降序排序,则应在该关键字后加一空格,再加DESC(如上例)。升序时ASC加不加无所谓。本操作是利用索引进行的,并未进行物理排序,所以效率较高。 16、事务处理 (1)、在事务开始时调用 (2)、在事务结束并成功时调用 (3)、在事务结束并失败时调用 在使用事务处理时,应尽量减小事务的范围,即减小从事务开始到结束(提交或回滚)之间的时间间隔,以便提高系统效率。需要时也可在调用BeginTrans()方法之前,先设置Connection对象的IsolationLevel属性值,详细内容参见MSDN中有关ADO的技术资料。 三、使用ADO编程常见问题解答 1、连接失败可能原因 ";Database=master;uid=lad;"; 如果不按上述操作,程序运行时连接必然失败。 如果Authentication选项是SQL Server and Windows NT,则你的程序所用的连接字符串可以不包含Trusted_Connection参数,如: "Provider=SQLOLEDB;Server=888;Database=master;uid=lad;pwd=111;"; 因为ADO给该参数取的默认值就是no,所以可以省略。我认为还是取默认值比较安全一些。 2、改变当前数据库的方法 3、如何判断一个数据库是否存在 m_pConnect->Execute ( _bstr_t("USE INSURANCE_2002"),NULL, adCmdText|adExecuteNoRecords ); } catch (_com_error &e) { blSuccess=FALSE; CString str="数据库INSURANCE_2002不存在!\n"; str+=e.Description(); ::MessageBox(NULL,str,"警告",MB_OK | MB_ICONWARNING); } 4、判断一个表是否存在 m_pRecordset->Open(_variant_t("mytable"), _variant_t((IDispatch *)m_pConnection,true), adOpenKeyset, adLockOptimistic, adCmdTable); } catch (_com_error &e) { ::MessageBox(NULL,"该表不存在。","提示",MB_OK | MB_ICONWARNING); } (2)、要不然可以采用麻烦一点的办法,就是在MS-SQL服务器上的每个数据库中都有一个名为sysobjects的表,查看此表的内容即知指定的表是否在该数据库中。 (3)、同样,每个数据库中都有一个名为TABLES的视图(View),查看此视图的内容即知指定的表是否在该数据库中。 5、类型转换问题 (1)、类型VARIANT_BOOL (2)、_com_ptr_t类的类型转换 (3)、_bstr_t和_variant_t类 6、打开记录集时的问题 7、异常处理问题 8、使用SafeArray问题 ...... //When the data are no longer to be used: ::SafeArrayDestroyData( psa); 我分析在定义psa指针时,一个SAFEARRAY的实例(也就是SAFEARRAY描述符)也同时被自动建立了。但是只要一调用::SafeArrayDestroyDescriptor,描述符就被销毁了。 9、重复使用命令对象问题 10、绑定字符串型字段问题 11、使用AppendChunk的问题 四、小结 |