|
|
一、ADO简介
* G: @3 J- V+ `, h) eADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。 * A1 Y% i1 Y2 Y; X2 X
本文示例代码
/ B2 g* G& H: c( m/ L
7 P7 \! ~$ E) h$ Y( ^' P1 U二、基本流程 2 |8 D- X, @& t9 a' G
万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
8 R6 S# X6 Y( ?$ ^9 B a* U(1)初始化COM库,引入ADO库定义文件 3 `! x0 I: P7 B
(2)用Connection对象连接数据库
7 t8 j" R s* s(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。
" ?9 i# R9 c- }; D$ h(4)使用完毕后关闭连接释放对象。 % @" S( r. T( @' C0 A
2 b6 P# t' x. c1 ]* }
准备工作: 4 m8 ]. q) V# Y6 E: F
为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。
( N: L% j9 g1 h" w下面我们将详细介绍上述步骤并给出相关代码。 / s+ F, {% x7 O) D8 Z) e
【1】COM库的初始化
# m* x, U4 D) N3 J$ ~我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码:
- s% t& t. i2 M/ x/ H9 F% J% f
7 u, F! a6 Q3 `% L% ^3 \2 V! G" x# V1 k4 i3 U$ }" B j, `4 ^
BOOL CADOTest1App::InitInstance() / S; \" I, K, k" Q, U0 A; C
{ 1 h& i4 J4 r/ n. R
AfxOleInit();
5 E0 V7 K" L. [3 l9 e. h( `1 p, i ...... . V3 r- s0 m. w# g
- {! d8 c3 j# Q3 f5 _$ `8 k【2】用#import指令引入ADO类型库
* ~/ g: o7 ` t$ _* u我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到) + ~! w z* Q3 c. w5 t
#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF") + P& d) k3 d9 P" W& \5 o
这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。
3 V9 X+ K) b+ M. \9 W0 G
2 `5 C. c( d3 z6 O: O! p几点说明:
( c/ Q: N0 P, y(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改 : S/ ]- \+ `; U3 J8 F
(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。
' S) ?& v) A2 J8 H9 Imsado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned
5 q c5 }! ]% l9 ]
) n3 F9 A4 y+ q L' H【3】创建Connection对象并连接数据库 9 B+ S) e' k2 b: e. U
首先我们需要添加一个指向Connection对象的指针:
/ C. L( ^8 v) O3 A, i$ u' X9 _: z8 __ConnectionPtr m_pConnection;
# k, R+ q8 X0 E4 D6 h下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。
# S9 S* o. T6 Z
$ S$ ` d; B8 \, |9 D' W- T; y# L9 G& r, A. j( |- N
BOOL CADOTest1Dlg::OnInitDialog()
$ l. a6 _9 S6 X: y5 u4 c7 _ { 1 o7 M: A8 m6 W, t& k$ y# {
CDialog::OnInitDialog();
; H+ I* h+ k6 K' g( B4 d HRESULT hr; 3 b9 Z1 x& S, d" F0 C" Y( {/ j" i3 S
try # ~2 l! i& O- O; c* U
{ 9 n: Q5 D; E7 {5 M' F$ J
hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象 * g; y4 ^8 N- F% l' F+ Q
if(SUCCEEDED(hr)) 6 n# G- J C, n) w9 I G
{ ! \4 g- O4 w5 W# |
hr = m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库
& p* d" u9 T* { ///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为 rovider=Microsoft.Jet.OLEDB.3.51; }
! O. M! Z, @8 R" v+ Y, d" h }
. C2 [. g! f/ h8 F catch(_com_error e)///捕捉异常 8 E; X: p8 N3 g! f: d6 q
{ 7 K* h; {3 T8 b$ P0 L) `3 @ z% p
CString errormessage;
( f- N; k2 Y9 ~ errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage());
" ]) W% q' W2 j AfxMessageBox(errormessage);///显示错误信息 : \* h+ F Z+ w* G
} G V. ^/ T% f* C6 j$ S
( r" @6 ]# t5 h* n5 n在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型 ; j# u% n! f- M7 ]% U
HRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options )
/ t9 l8 o+ B' c" x3 e$ nConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权,
) X% i: M1 C- f8 n1 n2 }! }Options可以是如下几个常量: 3 G+ ?) x+ j0 b+ K
adModeUnknown:缺省。当前的许可权未设置 2 @/ `5 Q: k& r* [; B$ D) _5 w
adModeRead:只读 1 m1 U2 T0 u$ f; c7 z. _4 A: L' A
adModeWrite:只写 ! s% O. I5 O* ?" e8 G' X
adModeReadWrite:可以读写
% ] i8 V' V6 V7 f1 gadModeShareDenyRead:阻止其它Connection对象以读权限打开连接 1 R4 v! s d* c1 o0 n; M# C+ N
adModeShareDenyWrite:阻止其它Connection对象以写权限打开连接 4 Q7 R% j6 R; K( U+ G
adModeShareExclusive:阻止其它Connection对象打开连接 : i" a+ D7 m; u& V5 Q
adModeShareDenyNone:允许其它程序或对象以任何权限建立连接
d7 G/ Z# m9 ]6 r) g5 y- u* N9 N
1 A2 L! b' }( R, x: K" B$ k8 `9 i我们给出一些常用的连接方式供大家参考:
" |( Z2 P1 ? R( i(1)通过JET数据库引擎对ACCESS2000数据库的连接 0 C# z D2 i# Z9 Z; f
' J5 \$ E! @; U' d9 cm_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown);
$ [. l5 B+ P, I6 |- }
$ q7 H e3 r$ D R. {(2)通过DSN数据源对任何支持ODBC的数据库进行连接: , ?5 ]) n; v3 K1 M
m_pConnection->Open("Data Source=adotest;UID=sa WD=;","","",adModeUnknown);
! q: R1 s7 W. n6 n# t* ~+ Q: v& R( \, c3 G) Q5 F& i
(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown);
/ e, e. Y4 X2 ~* ^# M
# G' H& a& w7 T9 v+ ?其中Server是SQL服务器的名称,DATABASE是库的名称
2 n/ ~ K- |9 M8 a: `2 w0 c8 W0 u6 P3 k4 o" u8 H5 G
Connection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State 9 X, t% V8 f# h$ M9 Z3 R6 M
ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
$ ^$ E# i. g7 Q( Tm_pConnection->Open("Data Source=adotest;","","",adModeUnknown); " P ^3 Z/ Z# b/ g
8 d9 m- t2 ^1 F0 T, e
/ W# R- E1 ~$ ]4 fState属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:
4 b- Q3 f* d0 {. Kif(m_pConnection->State)
3 b* C( v. T$ L9 @ m_pConnection->Close(); ///如果已经打开了连接则关闭它 5 D$ E% B- L9 X0 r. w
/ b5 f6 O& n6 J K1 Z
0 E e4 X N2 u3 P3 M( ?) `【4】执行SQL命令并取得结果记录集
' m1 q' @! a- z# a为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset; 7 E# o, D. u: M8 R y' e& e5 I x
并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset");
5 k# { S b0 X! dSQL命令的执行可以采用多种形式,下面我们一进行阐述。 ! @0 {) K- r8 ~( w# f
l/ Q; e/ c0 i" I1 m(1)利用Connection对象的Execute方法执行SQL命令 % {. Q# @/ H6 k C' c( E
Execute方法的原型如下所示: ; g" c# N/ B f9 f1 S/ c* y: d
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一: 1 l8 {/ X# C" H2 I2 x
adCmdText:表明CommandText是文本命令
* c, r% q2 r9 BadCmdTable:表明CommandText是一个表名
" B, I1 J) I. p2 ?adCmdProc:表明CommandText是一个存储过程
! T2 z. l; U) l& HadCmdUnknown:未知
; x' T0 d) X1 d- Q
. k. u3 w( z s8 j6 MExecute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。 _variant_t RecordsAffected; / Z5 o: u0 o. _: t" C! Q
///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday " H v3 U n, m, R/ ^* y2 d
m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); 8 R1 O9 S, o+ [; }9 h
///往表格里面添加记录 0 T- T9 W- f( b; C1 H
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText);
+ ]! N0 ~, t& Y9 o. x ///将所有记录old字段的值加一
+ m/ ]' ^9 ^5 G8 ~& _4 q7 d( ~+ R8 B m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
7 ~( I( W7 b% J k* H; N ///执行SQL统计命令得到包含记录条数的记录集 ( Z' [5 _5 Z6 M# n
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
j/ o1 }2 y, R _variant_t vIndex = (long)0;
) u* O9 O5 k# e# H _variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
* \4 y; W9 `( H5 V! Y: Z3 G m_pRecordset->Close();///关闭记录集 7 s7 Y% X: v$ `7 A
CString message; ; i2 E2 j0 n* _& U) ~9 [5 a w7 X
message.Format("共有%d条记录",vCount.lVal); 3 k' z0 b! ^. x! ^" l: w
AfxMessageBox(message);///显示当前记录条数
- N: H3 _8 m* T. j, o* I! h# L
9 ]$ p5 t- B+ U& E8 ]* c( a
# ^% G3 W* K/ }# s* C, i& ?' @* E(2)利用Command对象来执行SQL命令 l2 b( {% K: ^& Z
_CommandPtr m_pCommand;
" b5 a/ j* i# T }! `; {9 x+ }$ R m_pCommand.CreateInstance("ADODB.Command"); ; n: _; D" s/ n
_variant_t vNULL; 6 F% d( c- k$ l' O( h }$ Q
vNULL.vt = VT_ERROR;
$ T1 N4 T1 D5 X% n% f+ N+ C vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数
& T1 x( x0 x6 |* f4 M4 m m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它 1 M0 g* J1 A4 G
m_pCommand->CommandText = "SELECT * FROM users";///命令字串 * R X7 Z1 Z0 B
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集
6 t, j- \. p `& q: `! r/ R# u4 C; X& w: e5 E
在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
' y d/ e; f6 o! u+ ]7 Y# g4 s7 Q
' n3 {: A- M0 s(3)直接用Recordset对象进行查询取得记录集 6 L- @' T. t; a& |- o4 V8 ~. [ S: Q
例如 % M, L2 }; C5 ^0 M% {; B
9 o8 N, r+ m2 u7 s8 _( u% e m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); + _* w1 h% P+ j. e& V, [1 I. @
: \4 u- S$ g0 c1 V6 L% S
Open方法的原型是这样的:
, D F- z" W, c# T9 eHRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options ) I) W# w+ i9 L
其中: 9 k( G" d7 L x
①Source是数据查询字符串 $ W2 `4 _. c# `/ V! U. ?9 q6 ^
②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)
/ B* G, ?5 [- u# y$ p③CursorType光标类型,它可以是以下值之一,请看这个枚举结构: 7 b! k' ~) I4 Y# Q: n5 R6 V
enum CursorTypeEnum
6 e- p8 m. K+ S* ]& ^( `* `{ ) X# V [7 t4 w' y+ N4 R" ]& I
adOpenUnspecified = -1,///不作特别指定
) U/ Q$ L' Q6 X, \4 gadOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用 / Z4 K8 k; h1 x1 z( n. a
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 0 C. b0 ]+ ?& S3 g$ A2 A2 `
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
" Z) |0 J4 S7 S$ radOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
* s) s% ?) c+ I. K0 H. ?( d};
1 g6 c- u4 M/ a: g: Y5 V& C④LockType锁定类型,它可以是以下值之一,请看如下枚举结构:
2 Q7 y+ \7 ]8 i* X/ henum LockTypeEnum 1 ? m3 @+ A l
{
- M3 H+ F2 U' Q& [6 YadLockUnspecified = -1,///未指定
* k( i/ N7 C8 y* eadLockReadOnly = 1,///只读记录集
, h! E& k/ G' ~ P0 [adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制 1 G+ {$ n0 g' N! b
adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
# T) q7 K+ w- f, u9 ]' j4 WadLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。
* l6 f x `: X6 J1 ^- s" ~. |}; 6 H, n" @$ ]2 X$ w$ Q
⑤Options请参考本文中对Connection对象的Execute方法的介绍
1 a( Q) S" _. b* i0 _0 A ?( Y, \
* @# `$ Q% [/ x! [& h1 H# k7 R【5】记录集的遍历、更新 5 w7 L, `$ J: o% Y5 W- I
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday
' Y3 Y3 k2 X$ ?% X% h以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。
A# a0 j/ N: S7 H% V/ d* A
P" e" H% |4 ^4 m( L- F1 i" X' g/ @- \8 K! g. H, e
_variant_t vUsername,vBirthday,vID,vOld; ! D; K4 V) L; q& d% i9 C3 v3 j
_RecordsetPtr m_pRecordset;
1 V/ h6 J7 Y' Y! \/ zm_pRecordset.CreateInstance("ADODB.Recordset");
. ~ V0 |; V3 J% P4 I% X' q& e2 Pm_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); # ? O* O$ e& g
while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗?
0 h9 ~ \: V% ~4 q9 t; J{
( \- S {( M, v0 W2 J+ y4 W+ DvID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行
4 H+ A' f. r' d+ A, Z% r- ?. C6 C6 \vUsername = m_pRecordset->GetCollect("username");///取得username字段的值
: h% T9 _( H: ~% mvOld = m_pRecordset->GetCollect("old");
) m& x# @, r4 M% n6 a0 nvBirthday = m_pRecordset->GetCollect("birthday");
0 q: H1 H8 P; E% [///在DEBUG方式下的OUTPUT窗口输出记录集中的记录 5 n2 J' G7 o( i% G8 \5 u% }
if(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL)
' I4 S* q( b# I- I( m5 a2 A" Q TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
- Q6 m9 M4 d0 z- L7 D" N8 g2 pm_pRecordset->MoveNext();///移到下一条记录
! B7 r7 h- }9 ~" [4 c+ G} 1 P4 P7 m7 ^2 Z" b8 N
m_pRecordset->MoveFirst();///移到首条记录 8 H8 Q+ g, A' g0 ~& p
m_pRecordset->Delete(adAffectCurrent);///删除当前记录
$ K G6 n4 F6 r' p///添加三条新记录并赋值 % C! n+ I& X7 K% s+ a( O" W
for(int i=0;i<3;i++) 2 y' H9 R, |4 f% {& M; Z
{
j/ f, D# h: im_pRecordset->AddNew();///添加新记录
8 E- M" U6 a( \$ @- Am_pRecordset->PutCollect("ID",_variant_t((long)(i+10)));
* |7 {4 |2 I! om_pRecordset->PutCollect("username",_variant_t("叶利钦")); ( y8 X3 @4 X3 p8 @
m_pRecordset->PutCollect("old",_variant_t((long)71)); : L. \. p6 U( }) w
m_pRecordset->PutCollect("birthday",_variant_t("1930-3-15")); 7 {) V1 c; ~2 W& m5 C
} 2 B! _+ h8 n: ~# T/ t2 J
m_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处
: d- Z6 P; O0 [/ am_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄
2 n2 a2 h/ A8 l- V/ Fm_pRecordset->Update();///保存到库中 . [, U3 }; e) S
2 r0 v: Q+ r4 n; c【6】关闭记录集与连接 + i# q& @% z, X
记录集或连接都可以用Close方法来关闭
4 o3 A2 i8 ]1 [+ r! U m_pRecordset->Close();///关闭记录集
) e7 `% b/ a/ I! a8 W2 p }" R m_pConnection->Close();///关闭连接
: [0 |: E( V# k+ u5 c3 N
4 Z3 \1 X' N- u: J至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。
# o0 x* g! `: t- r# M( d4 `2 H8 O" M点这里下载示例代码 ) \* i3 q$ [. a+ _5 I) U
* N& G( F4 T5 k# R! U; [后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。 |
|