|
|
一、ADO简介
1 T' c8 x1 `7 L" wADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。 - l. `& v3 m7 B/ H0 ]
本文示例代码 V2 _6 }+ \8 @- h" Y
$ D( k5 D" W( ?; T4 a' T" F9 k0 H
二、基本流程 + F/ L; I7 L* S$ _$ i
万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
& a. _# a: ~$ p( `- W! U(1)初始化COM库,引入ADO库定义文件 . S; H# Y4 ~' n+ F2 U3 e
(2)用Connection对象连接数据库
# W- O, t0 \' M7 x! l(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。 ; w* h0 W" Q! u6 o( A+ x* ?2 s
(4)使用完毕后关闭连接释放对象。 ) L3 c3 ~( T1 r$ B
# A6 y e0 Q% K
准备工作: 7 {& G9 j' k0 C( y
为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。
3 y& t/ p0 C: v( F. S下面我们将详细介绍上述步骤并给出相关代码。 : h1 ~$ Q9 B0 c0 q2 R' n J( k& C: V% S# v' D
【1】COM库的初始化 ' t: a* P& W" Z# O9 V, B& ~ a; x
我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码: ) _# c9 f3 `+ E/ c* y
. I- Z, h3 b& R/ @$ U' n
$ W5 S9 U0 F9 t# CBOOL CADOTest1App::InitInstance()
. Q: g! g ~' E, W9 q {
# c" M, _" P! n) n1 u, e AfxOleInit(); , @+ c, o3 U# t2 f4 x- _' f
......
0 X2 L4 v V! [. x0 Q, n6 g. K; T$ v4 j- E. t8 D: `' @
【2】用#import指令引入ADO类型库
# z" H) H# m6 y$ Z我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到) 6 x5 F! b( u7 A4 |" N2 A+ ~8 B+ t
#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF")
5 }. a1 }. B2 m. u这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。
8 @" w6 z% ]7 C" `! H( a, M' {5 h! z- k' \# |) v) u. Q
几点说明:
9 J }0 F, @3 P; n- T(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改
) T2 B9 D6 c" Z# \- `(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。
, c: M& `7 L0 ]% V9 h" Jmsado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned
4 v3 Z/ G/ c5 i( [" D; }$ ~& c& b- t; `) J
【3】创建Connection对象并连接数据库 ) s' q4 P! D+ S( e6 C. `+ ^5 I$ a$ n
首先我们需要添加一个指向Connection对象的指针: $ s5 k6 z2 p0 [5 D& Z% ]+ f. ]
_ConnectionPtr m_pConnection; ' j2 Q( C& A, U! N
下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。 / ?: r% q5 L+ A! {# F2 x
" p+ X6 s0 b+ j: s7 W: x T
+ i8 k* n! d i2 v4 ^BOOL CADOTest1Dlg::OnInitDialog() 0 c) J- T$ B, {2 x- o6 h6 p7 q+ ?
{ 7 o4 K6 O" G. \1 D. \+ r
CDialog::OnInitDialog(); w5 v5 \! n. N; V$ p
HRESULT hr;
* N# `% v' R" n5 R# U1 h0 c- g try $ q* l' r" ]; T( p0 A& |
{
9 P0 H4 d: G1 o; {5 N2 `9 |, ] hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象
2 `. {; \6 w3 W7 b2 f if(SUCCEEDED(hr))
# {2 {, I" e; ]8 {; b5 m {
. Z( g5 s6 S+ Q$ `4 { hr = m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库 ! }: |" D7 o) ?: G# [
///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为 rovider=Microsoft.Jet.OLEDB.3.51; } 8 G5 N; w$ D8 u" s$ j1 Q( S
} 5 K4 W& j" n8 v
catch(_com_error e)///捕捉异常
2 J& B& i- _# G! R9 ` {
0 x: {( z( v0 c4 ]! ^. a CString errormessage;
h& ?* N: g2 r ]* f errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage());
1 I Q0 o% D7 | AfxMessageBox(errormessage);///显示错误信息 ; `) P) Q) [$ W5 V% o7 E/ u. @/ Y
} 5 o0 M$ l( e4 |2 z' g
' q( Q1 o- o, Y% u3 ^+ Z
在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型
# o. B+ ^7 W( {. n6 [/ RHRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options )
8 c4 @5 v" d7 g9 D: J9 mConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权, 7 K" @" ^0 n) [# g
Options可以是如下几个常量:
* m3 E3 o( L% D% A- P+ ~0 ]8 |adModeUnknown:缺省。当前的许可权未设置 $ N$ U5 x6 u* R z2 L) c
adModeRead:只读
9 v/ f( Q3 C& n) X6 x; madModeWrite:只写 0 B- c9 J& U/ A
adModeReadWrite:可以读写
5 v+ r8 {7 Y8 g: H& { T. v5 `adModeShareDenyRead:阻止其它Connection对象以读权限打开连接 : t# ?! N. T2 J9 M' z8 v
adModeShareDenyWrite:阻止其它Connection对象以写权限打开连接
2 Q) ]+ v# {- o( }; g+ d: FadModeShareExclusive:阻止其它Connection对象打开连接
8 T* E4 d! S# K* o' L% |adModeShareDenyNone:允许其它程序或对象以任何权限建立连接
+ P& l- |9 h3 i$ V; V8 z0 G+ ^ F& w3 y; F ]
我们给出一些常用的连接方式供大家参考: ( E2 H5 [8 k/ N) i. ^
(1)通过JET数据库引擎对ACCESS2000数据库的连接 6 C- z" n3 J) e- j! f# r1 g& r8 x) K
- x# T: h2 E% n- z2 L8 [8 Vm_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown); 7 i7 R! Y }, D0 E
$ E! e% N1 S1 d) S
(2)通过DSN数据源对任何支持ODBC的数据库进行连接: % m$ J* m* Q/ V& |0 c% e% i
m_pConnection->Open("Data Source=adotest;UID=sa WD=;","","",adModeUnknown);
! ~7 y! p. v! S/ n& U$ G$ ^8 j9 W" f9 S. R% J% L
(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown);
/ u6 P. E6 y5 l z4 i! V$ p' D5 Q# p& d, n" H. D) _
其中Server是SQL服务器的名称,DATABASE是库的名称 4 K) K/ \2 w- w
! ^: I* O$ i* IConnection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
+ E& H2 q% ~- t# K5 \ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
u& p: v1 _% [m_pConnection->Open("Data Source=adotest;","","",adModeUnknown);
0 @- j% _' q3 |$ g0 J7 d- E3 ^% ^6 J3 y$ ]2 E6 w' T t
7 J) c, O L, d& J x6 F! o
State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如: 3 n4 r$ ?1 Q2 A$ B. f$ ]6 r, V
if(m_pConnection->State)
- A( V6 `9 a; {8 W- O8 e m_pConnection->Close(); ///如果已经打开了连接则关闭它 ( E. D4 m; _" v; F6 Y* W
" y8 x$ j- c9 L+ q% {/ ?4 W) d
" m7 Z& Q) M% c; Z【4】执行SQL命令并取得结果记录集
! f3 F0 `- e4 x, ^9 e- N为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset;
9 {, q- \/ j+ g并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset"); 5 G! N' B6 @; g1 _
SQL命令的执行可以采用多种形式,下面我们一进行阐述。 4 n$ V0 H1 `' k4 S
W( T/ b) N1 _& `3 F( y: q, j
(1)利用Connection对象的Execute方法执行SQL命令
, `; V& Q1 z) q6 h1 ]) ?* DExecute方法的原型如下所示:
\/ W- o$ O6 v_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一:
% L/ x8 W a' H9 A, J1 {, AadCmdText:表明CommandText是文本命令
, }; H( P9 B$ | IadCmdTable:表明CommandText是一个表名
6 ]' s* J9 p% @6 L" O) QadCmdProc:表明CommandText是一个存储过程 % D5 I: c& m" k% b8 b
adCmdUnknown:未知
4 B: ^' v% s1 o/ U. B/ k
( _- N6 V3 d7 E4 Q5 `. zExecute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。 _variant_t RecordsAffected;
/ o& A6 ?" o0 C3 E" w# |; ? ///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday
: w7 }: d9 a% H1 g& l2 p' {3 @6 r m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); 8 Q: M3 j, n0 F& R
///往表格里面添加记录 2 Q, f/ P2 i. K, Y# z; n! u* f
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText); 7 q" T8 G4 U) Q4 S+ E! M8 z
///将所有记录old字段的值加一
7 B0 i0 K& y) {6 m4 Q# \/ O m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
; w/ }5 K! K4 V& P2 ~7 c1 C ///执行SQL统计命令得到包含记录条数的记录集
7 y9 ]' `! V/ s m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
$ ?& O0 D f+ f _variant_t vIndex = (long)0;
2 `+ A; r9 p; O7 O! Y; Z, m& M _variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
/ _) \5 W- M) Q; y% h( S8 Z m_pRecordset->Close();///关闭记录集
" f% d" h; h( a4 U CString message; 4 J$ y: D1 m1 m2 B
message.Format("共有%d条记录",vCount.lVal); 8 N! e7 _( \* J( Q3 k7 \
AfxMessageBox(message);///显示当前记录条数 6 K9 @1 R4 @. I$ O9 {2 E5 Y
8 x: p) \) D8 r6 A" V1 ~
8 q4 f+ Q, d4 I. _. M(2)利用Command对象来执行SQL命令
6 u# ^+ \' t3 \0 Y _CommandPtr m_pCommand;
* |7 i- a4 M; Q( \ m_pCommand.CreateInstance("ADODB.Command");
1 ~9 Y9 \( `) r/ l! y5 }) H _variant_t vNULL; 8 M# K) Q% }7 L% L# m& y d, o
vNULL.vt = VT_ERROR; . e7 g3 S- ]- B/ D: G
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数 / U6 c( J0 d1 y3 R2 t8 ^
m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它
0 c! A0 M. g+ q) P+ u m_pCommand->CommandText = "SELECT * FROM users";///命令字串
8 D! A2 ]5 T) ? m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集 6 i- W, }* W% X" p+ o: s
+ {2 q' L6 P y( g) a8 ]; a% Z" X/ t( \
在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
: m k: _1 l0 `6 ~+ R
@! y& P( n Q# h3 }5 }& a2 ^ R/ I
3 x# j. Y( z3 G1 D! |% c$ l4 P(3)直接用Recordset对象进行查询取得记录集 4 h" B% }' j8 U' k x
例如
: c" L3 C. B8 _5 d4 m6 d
2 ^3 _! w1 _, J E3 n% j1 \ m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); 1 x( k h6 E* d0 ]: h
. e- `5 m, U: a* o* Z7 S& f9 v. K9 xOpen方法的原型是这样的:
1 {" g& |, D5 v; k8 K! c( Y- BHRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )
& l" N+ q. v, N3 J" J: M8 L7 Z: q其中:
' M, O7 ^, r' q* J2 V& j5 @+ F①Source是数据查询字符串 ( W( H0 ^' u' L4 K1 g+ e a
②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)
9 Q+ H& c- \" S4 A③CursorType光标类型,它可以是以下值之一,请看这个枚举结构: ! t# Y; @; o0 V" N- U
enum CursorTypeEnum
1 P/ _' S7 l+ G' y- H0 B{ 1 E3 s* }+ K0 m5 N+ d( X
adOpenUnspecified = -1,///不作特别指定
- W# M, L! ?4 S, NadOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
* L' f, o4 H' B( j; w- r1 |8 ]adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 $ h0 w2 H3 d, x, y" X; a
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
9 d9 y$ ^( I3 m& x2 O3 G- u. dadOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
- T# O8 k8 ~1 \# C1 Y% M};
# |; A: K; v& d④LockType锁定类型,它可以是以下值之一,请看如下枚举结构:
! q( q; J2 B' ~% Henum LockTypeEnum
# F. J9 ^1 V+ | z. r% a1 r{ : w9 a9 ?" i% _1 ~
adLockUnspecified = -1,///未指定
5 q3 V( |! }, Z% U# `1 }adLockReadOnly = 1,///只读记录集
) G, P* m/ c8 z+ u, YadLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
+ Y) b4 ~; x6 c, s1 p# w, }adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
5 P3 o: H1 v% {( i, C% w( ?' }adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。
* n9 w9 D. q6 `6 y5 V4 d# r- A% n( `};
9 o' w6 A2 M6 \9 W⑤Options请参考本文中对Connection对象的Execute方法的介绍
5 x5 g% l- [) M. I$ v! [- o
8 q, E2 {1 d+ P1 t! |5 k4 s0 n0 C
【5】记录集的遍历、更新 # ^9 D1 J' y( I+ O
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday # a1 w9 v4 [: R( `, Z6 \
以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。 : b7 E* F1 o8 D4 B9 |) c
/ M) @0 D% m% F( N* K! x; [6 R
# y' O% @- Q4 y& ^_variant_t vUsername,vBirthday,vID,vOld;
$ {. [$ W/ G1 A% L3 D5 j& c_RecordsetPtr m_pRecordset; 5 A9 X2 Y1 t: `1 |+ \. I
m_pRecordset.CreateInstance("ADODB.Recordset");
5 C/ ?+ f" N2 y' |m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
$ r w# u6 a5 D! Lwhile(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗? 9 I" F, b- l5 K# D4 ]1 L
{
+ {1 ~6 V6 Z" `vID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行 : j0 N* ~4 s( u
vUsername = m_pRecordset->GetCollect("username");///取得username字段的值
9 b$ Q9 @6 e% L) y7 }0 u9 |vOld = m_pRecordset->GetCollect("old"); 6 \+ t, i4 V: J; @, {$ [' W
vBirthday = m_pRecordset->GetCollect("birthday"); ! `- O i+ S* D% b: U; o
///在DEBUG方式下的OUTPUT窗口输出记录集中的记录 - d9 Z$ V* u- U- x( _; r2 N
if(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL) , q- }* T, Q% c
TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday); 1 S0 i1 @8 Y- K2 }2 K$ I& x
m_pRecordset->MoveNext();///移到下一条记录
/ Y( _' W- q" {) a$ K} / m$ X6 n' {# K; c( V* w. d
m_pRecordset->MoveFirst();///移到首条记录
4 P+ A; B, ~ D: a1 z% Fm_pRecordset->Delete(adAffectCurrent);///删除当前记录 : G" F7 P- }5 E: Z t3 F
///添加三条新记录并赋值 5 i6 W! i$ [! i% e9 N* H. Y
for(int i=0;i<3;i++) : g+ s; T0 L+ M+ b
{ % c! s9 x% w1 A$ k1 U( j
m_pRecordset->AddNew();///添加新记录
* I% n9 n1 O, a2 Z( I. v$ p& Bm_pRecordset->PutCollect("ID",_variant_t((long)(i+10))); - W4 g. t; a* z9 c8 L
m_pRecordset->PutCollect("username",_variant_t("叶利钦")); ( U# s7 l% D6 I9 }
m_pRecordset->PutCollect("old",_variant_t((long)71)); i/ `$ s7 U! K5 q/ r1 C* S2 C) L# n
m_pRecordset->PutCollect("birthday",_variant_t("1930-3-15")); + M$ n& d( M. f: F7 R& U0 |
}
$ v- l* f" {- S# t6 d3 V2 r9 zm_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处 ' X' ?. b' _% K7 u8 A
m_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄 ( {, P9 X0 Z& s' T; d% C, C
m_pRecordset->Update();///保存到库中 8 A; v+ l/ S5 ]9 x
; ]5 M7 y7 c( G- Z3 @
【6】关闭记录集与连接 5 ]& s% {8 L3 B% r' S( [ m! m
记录集或连接都可以用Close方法来关闭 ' u0 {' p# s+ \ T
m_pRecordset->Close();///关闭记录集
! ]9 y/ k9 F4 V2 j m_pConnection->Close();///关闭连接 . g- j d+ E R0 }9 @2 |" ^- d
- @, n8 L# T) T" n0 p3 _& s0 u至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。
& D+ ?$ R1 i- Q3 k: v1 K3 k点这里下载示例代码 ; q* [0 p3 g7 x4 X& K' }
* q) F/ `' c) N7 [: V' z后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。 |
|