Visual C++ ADO数据库编程入门（上）

ADO 是目前在Windows环境中比较流行的客户端数据库编程技术。ADO是建立在OLE DB底层技术之上的高级编程接口，因而它兼具有强大的数据处理功能（处理各种不同类型的数据源、分布式的数据处理等等）和极其简单、易用的编程接口，因而得到了广泛的应用。而且按微软公司的意图，OLE DB和ADO将逐步取代 ODBC和DAO。现在介绍ADO各种应用的文章和书籍有很多，本文着重站在初学者的角度，简要探讨一下在VC++中使用ADO编程时的一些问题。我们希望阅读本文之前，您对ADO技术的基本原理有一些了解。

一、在VC++中使用ADO编程

ADO实际上就是由一组Automation对象构成的组件，因此可以象使用其它任何Automation对象一样使用ADO。ADO中最重要的对象有三个：Connection、Command和Recordset，它们分别表示连接对象、命令对象和记录集对象。如果您熟悉使用MFC中的ODBC类（CDatabase、CRecordset)编程，那么学习ADO编程就十分容易了。

使用ADO编程时可以采用以下三种方法之一：

1、使用预处理指令#import

#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("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

如使用如下代码：

CLSID clsid;
HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid);
if(FAILED(hr))
{...}
::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)
&pDispatch);
if(FAILED(hr))

以上三种方法，第一和第二种类似，可能第一种好用一些，第三种编程可能最麻烦。但可能第三种方法也是效率最高的，程序的尺寸也最小，并且对ADO的控制能力也最强。

据微软资料介绍，第一种方法不支持方法调用中的默认参数，当然第二种方法也是这样，但第三种就不是这样了。采用第三种方法的水平也最高。当你需要绕过ADO而直接调用OLE DB底层的方法时，就一定要使用第三种方法了。

ADO编程的关键，就是熟练地运用ADO提供的各种对象(object)、方法(method)、属性(property)和容器（collection）。另外，如果是在MS SQL或Oracle等大型数据库上编程，还要能熟练使用SQL语言。

二、使用#import方法的编程步骤

这里建议您使用#import的方法，因为它易学、易用，代码也比较简洁。

1、添加#import指令

打开stdafx.h文件，将下列内容添加到所有的include指令之后：

#include

  1<icrsint.h> //Include support for VC++ Extensions   
  2#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \   
  3no_namespace rename("EOF", "adoEOF")   
  4---  
  5  
  6其中icrsint.h文件包含了VC++扩展的一些预处理指令、宏等的定义，用于COM编程时使用。   
  7  
  82、定义_ConnectionPtr型变量，并建立数据库连接   
  9  
 10建立了与数据库服务器的连接后，才能进行其他有关数据库的访问和操作。ADO使用Connection对象来建立与数据库服务器的连接，所以它相当于MFC中的CDatabase类。和CDatabase类一样，调用Connection对象的Open方法即可建立与服务器的连接。   
 11  
 12数据类型 _ConnectionPtr实际上就是由类模板_com_ptr_t而得到的一个具体的实例类，其定义可以到msado15.tlh、comdef.h 和comip.h这三个文件中找到。在msado15.tlh中有：   
 13  
 14_COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection));   
 15---  
 16  
 17经宏扩展后就得到了_ConnectionPtr类。_ConnectionPtr类封装了Connection对象的Idispatch接口指针，及一些必要的操作。我们就是通过这个指针来操纵Connection对象。类似地，后面用到的_CommandPtr和_RecordsetPtr类型也是这样得到的，它们分别表示命令对象指针和记录集对象的指针。   
 18  
 19（1）、连接到MS SQL Server   
 20  
 21注意连接字符串的格式，提供正确的连接字符串是成功连接到数据库服务器的第一步，有关连接字符串的详细信息参见微软MSDN Library光盘。   
 22  
 23本例连接字符串中的server_name，database_name，user_name和password在编程时都应该替换成实际的内容。   
 24  
 25_ConnectionPtr pMyConnect=NULL;   
 26HRESULT hr=pMyConnect.CreateInstance(__uuidof(Connection)));   
 27if(FAILED(hr))return;   
 28  
 29_bstr_t strConnect="Provider=SQLOLEDB; Server=server_name;"   
 30"Database=database_name; uid=user_name; pwd=password;";   
 31//connecting to the database server now:   
 32try{pMyConnect-&gt;Open(strConnect,"","",NULL);}   
 33catch (_com_error &amp;e)   
 34{   
 35::MessageBox(NULL,e.Description(),"警告",MB_OK │ MB_ICONWARNING);   
 36}   
 37---  
 38  
 39注意Connection对象的Open方法中的连接字符串参数必须是BSTR或_bstr_t类型。另外，本例是直接通过OLE DB Provider建立连接，所以无需建立数据源。   
 40  
 41（2）、通过ODBC Driver连接到Database Server连接字符串格式与直接用ODBC编程时的差不多：   
 42  
 43_bstr_t strConnect="DSN=datasource_name; Database=database_name; uid=user_name; pwd=password;";   
 44---  
 45  
 46此时与ODBC编程一样，必须先建立数据源。   
 47  
 483、定义_RecordsetPtr型变量，并打开数据集   
 49  
 50定义_RecordsetPtr型变量，然后通过它调用Recordset对象的Open方法，即可打开一个数据集。所以Recordset对象与MFC中的CRecordset类类似，它也有当前记录、当前记录指针的概念。如：   
 51  
 52_RecordsetPtr m_pRecordset;   
 53if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset )))   
 54{   
 55m_pDoc-&gt;m_initialized=FALSE;   
 56return;   
 57}   
 58  
 59try{   
 60m_pRecordset-&gt;Open(_variant_t("mytable"),   
 61_variant_t((IDispatch *)pMyConnect,true), adOpenKeyset,   
 62adLockOptimistic, adCmdTable);   
 63}   
 64catch (_com_error &amp;e)   
 65{   
 66::MessageBox(NULL,"无法打开mytable表。","提示",   
 67MB_OK │ MB_ICONWARNING);   
 68}   
 69---  
 70  
 71Recordset对象的Open方法非常重要，它的第一个参数可以是一个SQL语句、一个表的名字或一个命令对象等等；第二个参数就是前面建立的连接对象的指针。此外，用Connection和Command对象的Execute方法也能得到记录集，但是只读的。   
 72  
 73  
 744、读取当前记录的数据   
 75  
 76我认为读取数据的最方便的方法如下：   
 77  
 78try{   
 79m_pRecordset-&gt;MoveFirst();   
 80while(m_pRecordset-&gt;adoEOF==VARIANT_FALSE)   
 81{   
 82//Retrieve column's value:   
 83CString sName=(char*)(_bstr_t)(m_pRecordset-&gt;Fields-&gt;GetItem   
 84(_variant_t("name"))-&gt;Value);   
 85short cAge=(short)(m_pRecordset-&gt;Fields-&gt;GetItem   
 86(_variant_t("age"))-&gt;Value);   
 87//Do something what you want to do:   
 88......   
 89m_pRecordset-&gt;MoveNext();   
 90}   
 91}//try   
 92catch (_com_error &amp;e)   
 93{   
 94CString str=(char*)e.Description();   
 95::MessageBox(NULL,str+"\n又出毛病了。","提示",   
 96MB_OK │ MB_ICONWARNING);   
 97}   
 98---  
 99  
100本例中的name和age都是字段名，读取的字段值分别保存在sName和cAge变量内。例中的Fields是Recordset对象的容器，GetItem方法返回的是Field对象，而Value则是Field对象的一个属性（即该字段的值）。通过此例，应掌握操纵对象属性的方法。例如，要获得Field 对象的Value属性的值可以直接用属性名Value来引用它（如上例），但也可以调用Get方法，例如：   
101  
102CString sName=(char*)(_bstr_t)(m_pRecordset-&gt;Fields-&gt;GetItem   
103(_variant_t("name"))-&gt;GetValue());   
104---  
105  
106从此例还可以看到，判断是否到达记录集的末尾，使用记录集的adoEOF属性，其值若为真即到了结尾，反之则未到。判断是否到达记录集开头，则可用BOF属性。   
107  
108另外，读取数据还有一个方法，就是定义一个绑定的类，然后通过绑定的变量得到字段值（详见后面的介绍）。   
109  
1105、修改数据   
111  
112方法一：   
113  
114try{   
115m_pRecordset-&gt;MoveFirst();   
116while(m_pRecordset-&gt;adoEOF==VARIANT_FALSE)   
117{   
118m_pRecordset-&gt;Fields-&gt;GetItem   
119(_variant_t("姓名"))-&gt;Value=_bstr_t("赵薇");   
120......   
121m_pRecordset-&gt;Update();   
122  
123m_pRecordset-&gt;MoveNext();   
124}   
125}//try   
126---  
127  
128改变了Value属性的值，即改变了字段的值。   
129  
130方法二：   
131  
132m_pRecordset-&gt;Fields-&gt;GetItem   
133(_variant_t("姓名"))-&gt;PutValue(_bstr_t("赵薇"));   
134---  
135  
136方法三：就是用定义绑定类的方法（详见后面的介绍）。   
137  
1386、添加记录   
139  
140新记录添加成功后，即自动成为当前记录。AddNew方法有两种形式，一个含有参数，而另一个则不带参数。   
141  
142方法一（不带参数）：   
143  
144// Add new record into this table:   
145try{   
146if(!m_pRecordset-&gt;Supports(adAddNew)) return;   
147  
148m_pRecordset-&gt;AddNew();   
149m_pRecordset-&gt;Fields-&gt;GetItem   
150(_variant_t("姓名"))-&gt;Value=_bstr_t("赵薇");   
151m_pRecordset-&gt;Fields-&gt;GetItem   
152(_variant_t("性别"))-&gt;Value=_bstr_t("女");   
153m_pRecordset-&gt;Fields-&gt;GetItem   
154(_variant_t("age"))-&gt;Value=_variant_t((short)20);   
155m_pRecordset-&gt;Fields-&gt;GetItem   
156(_variant_t("marry"))-&gt;Value=_bstr_t("未婚");   
157m_pRecordset-&gt;Update();   
158}//try   
159catch (_com_error &amp;e)   
160{   
161::MessageBox(NULL, "又出毛病了。","提示",MB_OK │ MB_ICONWARNING);   
162}   
163---  
164  
165这种方法弄完了还要调用Update()。   
166  
167方法二（带参数）：   
168  
169_variant_t varName[4],narValue[4];   
170varName[0] = L"姓名";   
171varName[1] = L"性别";   
172varName[2] = L"age";   
173varName[3] = L"marry";   
174narValue[0]=_bstr_t("赵薇");   
175narValue[1]=_bstr_t("女");   
176narValue[2]=_variant_t((short)20);   
177narValue[3]=_bstr_t("未婚");   
178  
179const int nCrit = sizeof varName / sizeof varName[0];   
180// Create SafeArray Bounds and initialize the array   
181SAFEARRAYBOUND rgsaName[1],rgsaValue[1];   
182rgsaName[0].lLbound = 0;   
183rgsaName[0].cElements = nCrit;   
184SAFEARRAY *psaName = SafeArrayCreate( VT_VARIANT, 1, rgsaName );   
185rgsaValue[0].lLbound = 0;   
186rgsaValue[0].cElements = nCrit;   
187SAFEARRAY *psaValue = SafeArrayCreate( VT_VARIANT, 1, rgsaValue );   
188// Set the values for each element of the array   
189HRESULT hr1=S_OK.hr2=S_OK;   
190for( long i = 0 ; i &lt; nCrit &amp;&amp; SUCCEEDED( hr1 ) &amp;&amp; SUCCEEDED( hr2 );i++)   
191{   
192hr1=SafeArrayPutElement(psaName, &amp;i,&amp;varName[i]);   
193hr2=SafeArrayPutElement(psaValue, &amp;i,&amp;narValue[i]); }   
194  
195// Initialize and fill the SafeArray   
196VARIANT vsaName,vsaValue;   
197vsaName.vt = VT_VARIANT │ VT_ARRAY;   
198vsaValue.vt = VT_VARIANT │ VT_ARRAY;   
199V_ARRAY(&amp;vsaName) = psaName;//&amp;vsaName-&gt;parray=psaName;   
200//see definition in oleauto.h file.   
201V_ARRAY(&amp;vsaValue) = psaValue;   
202  
203// Add a new record:   
204m_pRecordset-&gt;AddNew(vsaName,vsaValue);   
205---  
206  
207这种方法不需要调用Update，因为添加后，ADO会自动调用它。此方法主要是使用SafeArray挺麻烦。   
208  
209方法三：就是用定义绑定类的方法（详见后面的介绍）。   
210  
2117、删除记录   
212  
213调用Recordset的Delete方法就行了，删除的是当前记录。要了解Delete的其它用法请查阅参考文献。   
214  
215try{   
216m_pRecordset-&gt;MoveFirst();   
217while(m_pRecordset-&gt;adoEOF==VARIANT_FALSE)   
218{   
219CString sName=(char*)(_bstr_t)(m_pRecordset-&gt;Fields-&gt;GetItem   
220(_variant_t("姓名"))-&gt;Value);   
221if(::MessageBox(NULL,"姓名="+sName+"\n删除她吗？",   
222"提示",MB_YESNO │ MB_ICONWARNING)==IDYES)   
223{   
224m_pRecordset-&gt;Delete(adAffectCurrent);   
225m_pRecordset-&gt;Update();   
226}   
227m_pRecordset-&gt;MoveNext();   
228}   
229}//try   
230catch (_com_error &amp;e)   
231{   
232::MessageBox(NULL,"又出毛病了。","提示",MB_OK │ MB_ICONWARNING);   
233}   
234---  
235  
2368、使用带参数的命令   
237  
238Command对象所代表的就是一个Provider能够理解的命令，如SQL语句等。使用Command对象的关键就是把表示命令的语句设置到CommandText属性中，然后调用Command对象的Execute方法就行了。一般情况下在命令中无需使用参数，但有时使用参数，可以增加其灵活性和效率。   
239  
240(1). 建立连接、命令对象和记录集对象   
241  
242本例中表示命令的语句就是一个SQL语句（SELECT语句）。SELECT语句中的问号?就代表参数，如果要多个参数，就多放几个问号，每个问号代表一个参数。   
243  
244_ConnectionPtr Conn1;   
245_CommandPtr Cmd1;   
246ParametersPtr *Params1 = NULL; // Not an instance of a smart pointer.   
247_ParameterPtr Param1;   
248_RecordsetPtr Rs1;   
249  
250try   
251{   
252// Create Connection Object (1.5 Version)   
253Conn1.CreateInstance( __uuidof( Connection ) );   
254Conn1-&gt;ConnectionString = bstrConnect;   
255Conn1-&gt;Open( bstrEmpty, bstrEmpty, bstrEmpty, -1 );   
256// Create Command Object   
257Cmd1.CreateInstance( __uuidof( Command ) );   
258Cmd1-&gt;ActiveConnection = Conn1;   
259Cmd1-&gt;CommandText = _bstr_t("SELECT * FROM mytable WHERE age&lt; ?");   
260}//try   
261---  
262  
263要注意命令对象必须与连接对象关联起来才能起作用，本例中将命令对象的ActiveConnection属性设置为连接对象的指针，即为此目的：   
264  
265Cmd1-&gt;ActiveConnection = Conn1;   
266---  
267  
268(2). 创建参数对象，并给参数赋值   
269  
270// Create Parameter Object   
271Param1 = Cmd1-&gt;CreateParameter( _bstr_t(bstrEmpty),   
272adInteger,   
273adParamInput,   
274-1,   
275_variant_t( (long) 5) );   
276Param1-&gt;Value = _variant_t( (long) 5 );   
277Cmd1-&gt;Parameters-&gt;Append( Param1 );   
278---  
279  
280用命令对象的方法来创建一个参数对象，其中的长度参数（第三个）如果是固定长度的类型，就填-1，如果是字符串等可变长度的就填其实际长度。Parameters是命令对象的一个容器，它的Append方法就是把创建的参数对象追加到该容器里。Append进去的参数按先后顺序与SQL语句中的问号从左至右一一对应。   
281  
282(3). 执行命令打开记录集   
283  
284// Open Recordset Object   
285Rs1 = Cmd1-&gt;Execute( &amp;vtEmpty, &amp;vtEmpty2, adCmdText );   
286---  
287  
288但要注意，用Command和Connection对象的Execute方法得到的Recordset是只读的。因为在打开Recordset之前，我们无法设置它的LockType属性（其默认值为只读）。而在打开之后设置LockType不起作用。   
289  
290我发现用上述方法得到记录集Rs1后，不但Rs1中的记录无法修改，即使直接用SQL语句修改同一表中任何记录都不行。   
291  
292要想能修改数据，还是要用Recordset自己的Open方法才行，如：   
293  
294try{   
295m_pRecordset-&gt;Open((IDispatch *) Cmd1, vtMissing,   
296adOpenStatic, adLockOptimistic, adCmdUnspecified);   
297}   
298catch (_com_error &amp;e)   
299{   
300::MessageBox(NULL,"mytable表不存在。","提示",MB_OK │ MB_ICONWARNING);   
301}   
302---  
303  
304Recordset对象的Open方法真是太好了，其第一个参数可以是SQL语句、表名字、命令对象指针等等。   
305  
3069、响应ADO的通知事件   
307  
308通知事件就是当某个特定事件发生时，由Provider通知客户程序，换句话说，就是由Provider调用客户程序中的一个特定的方法（即事件的处理函数）。所以为了响应一个事件，最关键的就是要实现事件的处理函数。   
309  
310(1). 从ConnectionEventsVt接口派生出一个类   
311  
312为了响应_Connection的通知事件，应该从ConnectionEventsVt接口派生出一个类：   
313  
314class CConnEvent : public ConnectionEventsVt   
315{   
316private:   
317ULONG m_cRef;   
318public:   
319CConnEvent() { m_cRef = 0; };   
320~CConnEvent() {};   
321  
322STDMETHODIMP QueryInterface(REFIID riid, void ** ppv);   
323STDMETHODIMP_(ULONG) AddRef(void);   
324STDMETHODIMP_(ULONG) Release(void);   
325STDMETHODIMP raw_InfoMessage(   
326struct Error *pError,   
327EventStatusEnum *adStatus,   
328struct _Connection *pConnection);   
329STDMETHODIMP raw_BeginTransComplete(   
330LONG TransactionLevel,   
331struct Error *pError,   
332EventStatusEnum *adStatus,   
333struct _Connection *pConnection);   
334......   
335};   
336---  
337  
338(2). 实现每一个事件的处理函数(凡是带raw_前缀的方法都把它实现了)：   
339  
340STDMETHODIMP CConnEvent::raw_InfoMessage(   
341struct Error *pError,   
342EventStatusEnum *adStatus,   
343struct _Connection *pConnection)   
344{   
345*adStatus = adStatusUnwantedEvent;   
346return S_OK;   
347};   
348---  
349  
350有些方法虽然你并不需要，但也必须实现它，只需简单地返回一个S_OK即可。但如果要避免经常被调用，还应在其中将adStatus参数设置为adStatusUnwantedEvent，则在本次调用后，以后就不会被调用了。   
351另外还必须实现QueryInterface, AddRef, 和Release三个方法:   
352  
353STDMETHODIMP CConnEvent::QueryInterface(REFIID riid, void ** ppv)   
354{   
355*ppv = NULL;   
356if (riid == __uuidof(IUnknown) ││   
357riid == __uuidof(ConnectionEventsVt)) *ppv = this;   
358if (*ppv == NULL)   
359return ResultFromScode(E_NOINTERFACE);   
360AddRef();   
361return NOERROR;   
362}   
363STDMETHODIMP_(ULONG) CConnEvent::AddRef() { return ++m_cRef; };   
364STDMETHODIMP_(ULONG) CConnEvent::Release()   
365{   
366if (0 != --m_cRef) return m_cRef;   
367delete this;   
368return 0;   
369}   
370---  
371  
372(3). 开始响应通知事件   
373  
374// Start using the Connection events   
375IConnectionPointContainer *pCPC = NULL;   
376IConnectionPoint *pCP = NULL;   
377  
378hr = pConn.CreateInstance(__uuidof(Connection));   
379if (FAILED(hr)) return;   
380  
381hr = pConn-&gt;QueryInterface(__uuidof(IConnectionPointContainer),   
382(void **)&amp;pCPC);   
383if (FAILED(hr)) return;   
384hr = pCPC-&gt;FindConnectionPoint(__uuidof(ConnectionEvents), &amp;pCP);   
385pCPC-&gt;Release();   
386if (FAILED(hr)) return;   
387  
388pConnEvent = new CConnEvent();   
389hr = pConnEvent-&gt;QueryInterface(__uuidof(IUnknown), (void **) &amp;pUnk);   
390if (FAILED(hr)) return rc;   
391hr = pCP-&gt;Advise(pUnk, &amp;dwConnEvt);   
392pCP-&gt;Release();   
393if (FAILED(hr)) return;   
394  
395pConn-&gt;Open("dsn=Pubs;", "sa", "", adConnectUnspecified);   
396---  
397  
398也就是说在连接(Open)之前就做这些事。   
399  
400(4). 停止响应通知事件   
401  
402pConn-&gt;Close();   
403// Stop using the Connection events   
404hr = pConn-&gt;QueryInterface(__uuidof(IConnectionPointContainer),   
405(void **) &amp;pCPC);   
406if (FAILED(hr)) return;   
407hr = pCPC-&gt;FindConnectionPoint(__uuidof(ConnectionEvents), &amp;pCP);   
408pCPC-&gt;Release();   
409if (FAILED(hr)) return rc;   
410hr = pCP-&gt;Unadvise( dwConnEvt );   
411pCP-&gt;Release();   
412if (FAILED(hr)) return;   
413---  
414  
415在连接关闭之后做这件事。</icrsint.h>

Visual C++ ADO数据库编程入门（上）

#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \no_namespace rename("EOF", "EndOfFile")

CLSID clsid;HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid);if(FAILED(hr)){...}::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)&pDispatch);if(FAILED(hr))

#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")

CLSID clsid;
HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid);
if(FAILED(hr))
{...}
::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)
&pDispatch);
if(FAILED(hr))