|
|
一、ADO简介
& p: N) E3 e$ M4 NADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。 6 |, I! O7 i- n* _
本文示例代码 ! S( W7 }3 V/ L; }+ ~( r
6 [0 v$ ~8 X* e0 W' n$ D5 z# a二、基本流程
. b5 p+ ~2 N! Y9 n7 Z k" t万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
. c5 g1 V$ g- Q1 a5 p7 _(1)初始化COM库,引入ADO库定义文件 " U6 | V! O% A9 i$ @
(2)用Connection对象连接数据库 ) h, q' ?! z9 E2 t8 b
(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。
" S% r* t+ j( T2 z(4)使用完毕后关闭连接释放对象。 7 e+ M( a D# ~: E3 P+ n6 a* X
; y2 F" a0 w1 A* @4 Y
准备工作:
. ?. \7 D) F7 N为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。
( C3 ?0 `; ]3 _) v下面我们将详细介绍上述步骤并给出相关代码。 , L( {; c6 s3 @: R& p
【1】COM库的初始化
; x6 {3 _$ g* t' v. R1 D我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码: 8 Q0 d1 G* k! K
. q6 k0 |8 A0 E% \. r
; J' K% Z' c' ^. ?BOOL CADOTest1App::InitInstance()
- [2 W2 K$ z3 q% K+ u; Y {
4 X* |9 f7 {+ A, z0 v% i9 N, z AfxOleInit(); 8 q9 Y5 l8 b( ?# m: N: n
...... " I2 e' ^$ w' [1 d, W* F
; t: B; W! v3 S: d【2】用#import指令引入ADO类型库
1 w6 Z$ _% R1 ~9 p: W我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到) # r5 P/ p8 F. S7 W/ t! S
#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF") $ _( U: k! W& V% o& @
这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。 : i! V3 j5 I& e5 W- k1 c! h- h n
* w& f n4 }7 q
几点说明: # D* z& }& y$ F/ ~7 i
(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改
& p1 S6 b( e4 s0 ^(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。
. c% G) V3 B+ v$ E8 p' \+ m/ Rmsado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned $ B6 ?. @$ Z: |/ n$ i6 d$ }% `" q
. U5 w7 S+ [- Y# `# F8 ~0 {
【3】创建Connection对象并连接数据库 * |( \: `+ c- ] {7 X6 B/ P4 H
首先我们需要添加一个指向Connection对象的指针:
1 }' L1 b. ^/ D) Q7 w) y$ F_ConnectionPtr m_pConnection; % {8 U. H; c* c7 k
下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。
' `$ X* I) M9 p) ]4 A( ?, V; B1 L b* h" k3 n3 W# k
^6 _: y. N& m! TBOOL CADOTest1Dlg::OnInitDialog() - ^! L/ x' I2 {- }3 b
{
! U, q6 v1 A/ C9 T; ^$ u4 X4 P CDialog::OnInitDialog(); ( S5 y) _4 m% j- t, H4 M- q- K7 y
HRESULT hr; ; B* V; q L6 R H) W% V
try
# @3 r3 K# b- L( a2 {2 b. m) h9 x {
* o) j2 a3 k# l6 [ hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象
; |' C2 W0 I- `9 `3 C: P8 t if(SUCCEEDED(hr))
4 Q4 U' |! b* n; H) x& P5 m* m$ y {
5 n( F" i" z- p9 d- f& {# o hr = m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库
+ Y' ]' z: ?: _. e Z% ^2 u7 z r ///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为 rovider=Microsoft.Jet.OLEDB.3.51; } . h+ T( d7 L& N; r! |+ d3 l* F
} , n6 Z8 z0 v6 f
catch(_com_error e)///捕捉异常 , I9 {% h2 j7 h _. s
{
) x9 B, a% A3 p CString errormessage; 3 X) j% \7 ]+ F8 l
errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage());
- x: l, j2 K/ c1 {% f6 C% i AfxMessageBox(errormessage);///显示错误信息
) Q& x2 v" }' {! v; c# E }
/ l+ M. r' J! R9 p
0 S2 m+ @! {9 e! @8 j) _; P在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型 * U9 o# `$ m6 n- A" R% }
HRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options ) ( e" \9 Z% H4 c& ^
ConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权,
5 F5 Z: c' A9 ~9 aOptions可以是如下几个常量: o/ g1 @, g; z2 E# j
adModeUnknown:缺省。当前的许可权未设置
) S6 [) { _* w) I2 tadModeRead:只读 7 v& }* j. v. E" C& i7 ^) S" R3 P3 R
adModeWrite:只写 ( m5 c o; R" R/ C
adModeReadWrite:可以读写
- p* W3 q( L' d" sadModeShareDenyRead:阻止其它Connection对象以读权限打开连接 5 }+ ~; C- K/ D. Q& R2 Q2 e
adModeShareDenyWrite:阻止其它Connection对象以写权限打开连接 ) d* ]+ r9 W) v# |5 B
adModeShareExclusive:阻止其它Connection对象打开连接
9 |9 j- G& y0 e1 v! `1 L( K) }adModeShareDenyNone:允许其它程序或对象以任何权限建立连接
: N% F& X2 e* G: k) |; e! c$ D; @
% ~! T6 B) l6 K. N% U! \我们给出一些常用的连接方式供大家参考: . U, a+ f; M' X! B" s- O' t
(1)通过JET数据库引擎对ACCESS2000数据库的连接
8 A% h) h& y+ w0 R. D' i7 e
% \: A( b( P- o+ ? T% \/ Z! jm_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown);
/ F& V2 w/ f; G& _* B5 K% O8 h! A
(2)通过DSN数据源对任何支持ODBC的数据库进行连接: 8 c+ W {+ A8 [0 Q+ T
m_pConnection->Open("Data Source=adotest;UID=sa WD=;","","",adModeUnknown);
9 [4 T6 Q' G# ~# L& O! R) v) o* b9 E
(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown); . [1 O) Y* D1 c5 X$ Z
0 C* X. q, g5 e) R: C/ ?其中Server是SQL服务器的名称,DATABASE是库的名称
. m0 `8 k6 O# H* ]0 H6 X6 ]
$ V8 j% p5 g0 V: |/ ?) \Connection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
9 i4 R1 E W5 h6 Y* B: x4 m0 i8 _ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒 8 k: q; b3 b" ^
m_pConnection->Open("Data Source=adotest;","","",adModeUnknown); ) D, M. ]" |5 ?" g' C
4 n+ y' o/ N$ y: ?2 F# A" R0 X* ^
: i; @+ a( u2 `& x6 y7 j3 `State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:
+ v& X% I4 S! Nif(m_pConnection->State)
( o/ Y* |; c0 p m_pConnection->Close(); ///如果已经打开了连接则关闭它 + E. a/ F( r5 w* J$ z
' P9 p5 t6 D' x
! O' t: K# q6 U. s# m【4】执行SQL命令并取得结果记录集
; k c7 U N+ U1 s9 V3 n7 K. z8 S为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset;
e7 D$ m) c; N$ I* E5 u4 g并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset"); ; a! ^- [9 Z8 ?
SQL命令的执行可以采用多种形式,下面我们一进行阐述。 8 a2 |# ^2 m" Q/ s' D; b) |% \$ e
3 a% ?* d; m& h' y/ t(1)利用Connection对象的Execute方法执行SQL命令
, W/ I- _: d8 }9 k4 b1 JExecute方法的原型如下所示:
* G X# _( B6 r- N_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一: 2 E$ W, t3 Y9 U& B! w
adCmdText:表明CommandText是文本命令
- v5 O0 k% j) f4 `5 }% s& _adCmdTable:表明CommandText是一个表名 ! i; D: T8 J4 D1 [" e/ D
adCmdProc:表明CommandText是一个存储过程
: }) t# q: o- ladCmdUnknown:未知
! u s) U ^$ W$ z3 x- U
, u' v8 {, w' f( h, D" mExecute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。 _variant_t RecordsAffected; 4 J, G% A0 c' t
///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday 9 G9 j: j; a& K
m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); g; x* v" u2 Q; Q
///往表格里面添加记录
! |; g, y, _3 R1 m" S m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText);
" j h" e9 s) J" y" X6 L ///将所有记录old字段的值加一
+ u: i6 ]3 E4 F3 `- S2 f m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText); 8 F/ k2 a- D, r6 D) B6 c' C- c
///执行SQL统计命令得到包含记录条数的记录集 8 S7 }; o9 D J) Q
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
! U" r$ l2 z4 w$ U9 J; `- h _variant_t vIndex = (long)0;
, Q5 C3 ~) M& X' x' t! n8 o2 h$ n _variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
7 W b4 _: u+ c" M m_pRecordset->Close();///关闭记录集
( P( o7 N1 K+ J: e( g$ B2 V' X CString message;
# A% b( R( d2 R message.Format("共有%d条记录",vCount.lVal);
. ~, A% Z* R# r4 U- {3 r AfxMessageBox(message);///显示当前记录条数 0 }6 t3 R8 {; Y* W0 J9 e! u
' {8 G$ p, l, z$ `/ C
7 F$ n% L3 F9 h1 g+ Y(2)利用Command对象来执行SQL命令 5 r& Q2 t9 s* m
_CommandPtr m_pCommand;
$ J. s: E+ T8 G* @3 t- N$ C m_pCommand.CreateInstance("ADODB.Command");
% x" i! w/ A9 G8 `7 h" O, Z _variant_t vNULL;
* B, ^+ U, R( E vNULL.vt = VT_ERROR;
3 f2 ^# Z, k, e; b/ x; d m vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数
1 _" J4 y: A( }! r$ Z( c m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它 * ?9 F$ _2 ]7 Z. s1 r6 }) f
m_pCommand->CommandText = "SELECT * FROM users";///命令字串 $ h# C1 m+ |( H9 d% p+ m4 X0 B
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集
7 i+ c8 d7 ?; z1 ?# x9 D
1 m) L" j! q. f( r/ A; R( M& n在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
4 R# e$ ~& ~$ r0 o+ F) n. a
' [: M% B; a7 @& c* K1 Z
( A" r( M- m) u) E+ X# |2 s(3)直接用Recordset对象进行查询取得记录集
1 l4 E& \0 z; x例如 9 W7 `. n6 P+ X& U% }
% J8 F# ?3 O; K% N4 f m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); $ a, j7 {. N9 p0 N, i) ]5 u# v
) x8 }" N) m3 F% k. i+ e
Open方法的原型是这样的:
- E N; _+ y5 B# r, I4 {' @9 gHRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options ) . T9 R# Q7 P% {# M% A. x# c7 q0 `
其中:
9 k" m5 r9 S0 x4 v& S①Source是数据查询字符串 / I: }1 o% A/ ?1 o$ t
②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象) . F, |9 Z( g/ N
③CursorType光标类型,它可以是以下值之一,请看这个枚举结构: 4 O3 b7 F9 u5 Q4 H) @
enum CursorTypeEnum 7 y- L) U! _4 q% b( Y& t, e
{
0 h9 a3 Z) i; q/ t$ H! d$ q( gadOpenUnspecified = -1,///不作特别指定 2 t4 [+ A. Q' E, c! d3 U
adOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用 , d. s. i* v2 T, J3 l
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 ( F5 \- X* u- s2 p9 j* o
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
- C# L4 H @ Q5 Z I4 |8 WadOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。 3 g% h3 m$ E* P( U6 r
};
1 \+ o- U1 n3 A& U; R& H④LockType锁定类型,它可以是以下值之一,请看如下枚举结构: 0 O O8 C) [, H
enum LockTypeEnum
2 n3 t3 I3 u/ _1 J5 L- L{ 5 e2 i' W/ [" m7 {2 R
adLockUnspecified = -1,///未指定 o. f9 `8 V3 E* x& r5 f! s
adLockReadOnly = 1,///只读记录集 + G. o3 |8 t# _6 g. ~
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制 9 T( ~8 p7 v& e" S2 l/ A2 r: Y) M
adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作 8 _- I! Y: Q* l
adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。
" m4 I1 z0 z. ?; c& Y};
- [: {. q1 D8 Z# G% ~1 t4 j⑤Options请参考本文中对Connection对象的Execute方法的介绍 . C8 D7 {( ^( N7 k' \
8 M2 y" e' Q9 |' Z- w
; E- P/ S, }! c) L, P; F【5】记录集的遍历、更新 4 ^) R* }3 c7 f7 ]( G: @
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday
( Y3 s( `2 j' e8 Y- i以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。 - q }5 m0 E* `
) A7 G/ m; D0 j7 t
/ D% b/ ?$ h1 }1 C_variant_t vUsername,vBirthday,vID,vOld; . F/ F* y, T* j! r: i0 @ h
_RecordsetPtr m_pRecordset; 8 C: {5 C5 i Z
m_pRecordset.CreateInstance("ADODB.Recordset"); 4 Q, z$ A' N1 s8 V% e- P5 Z
m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); - q# b8 @. e6 N2 m
while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗?
% @/ A" o! h9 M" G2 e1 m{
" ]* b7 u$ o! r; j$ kvID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行 ; D8 r% l' h; Z( ^1 F- ?
vUsername = m_pRecordset->GetCollect("username");///取得username字段的值 4 r* k8 y- Y7 o
vOld = m_pRecordset->GetCollect("old");
+ U$ C9 k. f0 B% n/ d+ m$ f1 jvBirthday = m_pRecordset->GetCollect("birthday");
P2 d5 f: M8 T( Y///在DEBUG方式下的OUTPUT窗口输出记录集中的记录 ) g+ A' r- A# O. A; t
if(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL)
" }% H9 ~' C& D! V% ]& S, w3 @2 P9 p TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday); - ?, l0 L3 C$ }) K9 T A
m_pRecordset->MoveNext();///移到下一条记录 3 T/ z! q# l7 j- k* @
}
/ h3 n: b1 R' }, um_pRecordset->MoveFirst();///移到首条记录
% r1 I' t0 ]# F I* k ?( t9 bm_pRecordset->Delete(adAffectCurrent);///删除当前记录
% V s3 k. u3 ^3 } ?) k% ?///添加三条新记录并赋值 . H( f- Q9 F4 p( q3 B& u- ?# V' Z
for(int i=0;i<3;i++) ) F. i# Z; R% p/ q
{ # w' t6 ~; {) |+ H
m_pRecordset->AddNew();///添加新记录
2 }8 H( ]5 V* U7 I& zm_pRecordset->PutCollect("ID",_variant_t((long)(i+10)));
% m; C4 O' B% _& Y& W" |* M7 jm_pRecordset->PutCollect("username",_variant_t("叶利钦"));
0 x6 N1 j% k8 h: F0 U. l- N+ Lm_pRecordset->PutCollect("old",_variant_t((long)71));
3 y' I3 F: e, D' d) d1 U- Km_pRecordset->PutCollect("birthday",_variant_t("1930-3-15")); 1 g3 p- K; E T5 n
} / L: W5 ^$ R* g
m_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处
& \6 K+ r- v8 l: M2 ^! W! mm_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄 6 s2 h% u2 |; _& c: P v9 K
m_pRecordset->Update();///保存到库中
2 e! H# J6 V4 o6 q. q7 t1 r- q+ a" p6 o3 ~+ W
【6】关闭记录集与连接 , `! g7 S/ t; n5 q& i0 t
记录集或连接都可以用Close方法来关闭
, B5 ~/ C% x' W3 \# j; N: ?( Y' L m_pRecordset->Close();///关闭记录集 ) b: W# ?+ `+ q* }' f) ~& y0 j
m_pConnection->Close();///关闭连接
1 t5 _) g. {6 x& v9 c
# h, t$ h# s- c, \, ~$ M L至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。 ; H$ ^* R- S6 h5 f! G
点这里下载示例代码 8 l; n ?' L5 q$ ^) N
2 l9 ^8 r& ~ j' N9 L( m7 B# M. j0 @
后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。 |
|