|
一、ADO简介 , c: @4 R/ ] U. r& @: X8 C, f
ADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。
8 @/ z2 n5 d2 e6 t' x本文示例代码
X! g' b! \* T- Z4 M$ R$ c$ c8 I7 |# A; u
二、基本流程
% ?- ]8 k! c6 @7 t& H万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧! ' g0 n2 R# O: I& Y( F' m' Z0 e% y
(1)初始化COM库,引入ADO库定义文件 % R+ c, G$ n5 n3 ^) Q7 Y3 ]3 @
(2)用Connection对象连接数据库
4 t* V/ {8 G) |( c1 k, i4 ~(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。
' X9 C! Y9 P7 z6 i(4)使用完毕后关闭连接释放对象。 & }! ~. h/ ]+ P# |
7 I1 M Z. V* |1 \7 U" K) P8 Z+ x* c
准备工作:
" a! D$ J6 D* o2 S为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。 * a& M4 Z6 D/ A& p
下面我们将详细介绍上述步骤并给出相关代码。 2 ?# j% d% I, V/ M
【1】COM库的初始化
6 T% }7 h/ L5 p( u2 g8 `我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码: - `% |: x& v) G* o' l V ?6 C
. L6 c5 a7 d: q7 e! J' b3 X6 @' T
/ V% ^$ R8 Q+ }BOOL CADOTest1App::InitInstance() 1 V5 n! [; Q: M2 Q) [( P* v- v
{
9 M5 v* e( T- @ AfxOleInit(); ' q9 E4 g% U8 N { d/ I
...... 7 d4 P/ v- J0 [' ]5 ?
# l. q; ]8 m8 x+ P【2】用#import指令引入ADO类型库
1 d3 j7 S" z+ l8 w2 m) v我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到)
( c T" |3 ~$ U- }# Z0 L#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF")
+ B8 }5 V) ^; A; \' a! Z# H- z这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。 9 @- C' C7 x6 s6 J2 x# D
; u4 a, B ^2 ^几点说明: ( @2 `# R' s1 T
(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改
8 E; m. O: x/ s; |& t( b(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。 ( D( A2 x$ L, f3 Y/ x% F" d9 Y
msado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned 4 ]1 {# D4 L |" n4 M/ f2 X! g
/ `7 E- U$ h' b【3】创建Connection对象并连接数据库
* v" S+ r+ ^) r" S) `$ S0 l$ u首先我们需要添加一个指向Connection对象的指针:
7 ]- E4 X$ p, p S% Q( A& k_ConnectionPtr m_pConnection; ( A1 u0 b2 W8 V) D0 c5 T" y, V/ J2 A1 v
下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。
6 \+ _0 o# B: M' Q% F& Y" D! }
/ \/ _2 m4 x. E2 P7 ^5 E1 p
+ |* O0 L' ?" uBOOL CADOTest1Dlg::OnInitDialog() , i+ R* ]$ t/ E1 N. v) S
{
0 w* y/ s2 G* q# u CDialog::OnInitDialog();
" R) M, `0 L" A4 [ HRESULT hr; p, p. v9 @( {3 L2 d, T' @
try
, _ r# |7 P1 f# ? { # j& z; y2 y$ j* b1 b7 d M& M
hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象 # T. H3 s7 \8 g
if(SUCCEEDED(hr))
1 H' ?8 ~6 \3 V8 {; P { ' u2 [' c. }6 ?+ a4 E
hr = m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库 : ~7 O. g. a8 |; G2 Y' ^
///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为 rovider=Microsoft.Jet.OLEDB.3.51; } $ U- n5 q! U" g o4 j' X) P
} 6 F& f) ?# X' I% M% z* v- c+ n
catch(_com_error e)///捕捉异常
/ \ X V( X7 u2 x {
7 Z: @1 |: B6 Z F- I4 n$ | CString errormessage;
9 @; b) Q+ f2 K( T, [2 }" ?: X errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage()); 0 F1 ~% _; ^- b8 Z, \
AfxMessageBox(errormessage);///显示错误信息
, R( s, d5 ~) J }
* L# \1 l% T; t# d% `# a: \8 `0 `) |. D0 }
在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型 . o* ^! ]' G6 F) \% T- w
HRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options ) ( w" T, k2 \- X) c1 g
ConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权,
0 j# ?* M! u7 A4 Z4 l# h/ p% BOptions可以是如下几个常量:
; \& o. {9 f% {& R9 G+ w9 qadModeUnknown:缺省。当前的许可权未设置
8 o9 h8 V+ b3 a$ z( r3 ^3 xadModeRead:只读 9 w& p3 }# z$ G6 @2 c
adModeWrite:只写 2 [! I+ D6 U3 S& F8 |7 `/ {* D
adModeReadWrite:可以读写 # S$ ?9 s) C3 h; {) W; D* Q
adModeShareDenyRead:阻止其它Connection对象以读权限打开连接
/ _9 q: j; T# A6 l! U2 V1 K( u( cadModeShareDenyWrite:阻止其它Connection对象以写权限打开连接
1 b3 u) F. ~$ Y7 t8 RadModeShareExclusive:阻止其它Connection对象打开连接 8 L+ Q: [9 z8 [0 ^3 j* E
adModeShareDenyNone:允许其它程序或对象以任何权限建立连接
' F4 A3 R; k# W+ ~% R3 M6 U% A
' l: c: l' Z* j: ?8 ?+ {" M我们给出一些常用的连接方式供大家参考: 5 ]( I6 _* l. H3 d0 u4 }- d! X% j
(1)通过JET数据库引擎对ACCESS2000数据库的连接 ! W+ l! }. X0 n* `: D" P
1 A5 X4 d9 L& x9 q" c& Fm_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown); 7 S V. P( Z2 j- j5 X
% P- F7 y$ D V. W
(2)通过DSN数据源对任何支持ODBC的数据库进行连接: ; e2 x( O$ U, {9 y! A7 a0 ]" X
m_pConnection->Open("Data Source=adotest;UID=sa WD=;","","",adModeUnknown); # T) h( H( Y' c: y Z4 ^& c
& E, k0 X# f5 N3 z
(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown); ' m% F0 o$ R j3 b7 b7 |9 p
4 K/ F5 r! A+ F5 W/ a其中Server是SQL服务器的名称,DATABASE是库的名称 : k- \, ?, |/ ^% ]/ a6 o
# V) h$ G9 q! v1 i9 s0 KConnection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
& [) k7 y4 \3 V5 k3 N- nConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
* ^4 p& W d4 X5 um_pConnection->Open("Data Source=adotest;","","",adModeUnknown); ! _, A; d5 h; T$ {# M
8 P- S3 M1 }5 Z2 H* \9 H4 }' j0 Q6 d6 Q1 [' C) s% E$ j8 e; S0 r0 x
State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如: / f) @6 M2 _# T# b2 E- Q
if(m_pConnection->State) + B; x! w j) i0 R+ `. C) n! ?. E
m_pConnection->Close(); ///如果已经打开了连接则关闭它
& Z; D3 M; J" x1 n* s; p
8 i9 _- n% ^7 W2 G3 `# d2 m
& F3 [7 C& ]9 v+ {+ {* G/ Y3 C【4】执行SQL命令并取得结果记录集 - [ M( W0 r" w) y' k0 w' y* |
为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset; ; H x7 G' {" c, y" x
并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset"); 3 B" S+ `$ K5 D
SQL命令的执行可以采用多种形式,下面我们一进行阐述。 3 E" H. ^2 s. d
; P4 r9 w* N4 @' U9 c
(1)利用Connection对象的Execute方法执行SQL命令 3 R9 @& K6 x! f9 {
Execute方法的原型如下所示: 4 Q- N& M8 \- e' ?
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一: $ J' ]: j" [ ~1 }9 A, C1 {' j6 u
adCmdText:表明CommandText是文本命令
; w$ y" u% L6 U% vadCmdTable:表明CommandText是一个表名 * v! @: d- }" v. H- }0 v1 x0 g* ~
adCmdProc:表明CommandText是一个存储过程
2 [9 q2 t' e5 H" B3 y$ vadCmdUnknown:未知
- a/ Y, ?- O3 e# W2 j; F
" q- C$ T4 o/ `6 v1 {Execute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。 _variant_t RecordsAffected; - g* ~; U" h P/ p$ W# A
///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday
7 \( L$ f6 c' E( n9 O m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); % ]: {6 F8 l! A$ Q6 ~# @. S
///往表格里面添加记录 7 N) A6 N1 b$ {5 v3 k y
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText); 9 }2 v' M S5 y! f
///将所有记录old字段的值加一
0 L' h. g9 R/ X8 v0 a m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText); ; p3 U& y2 V2 ?: A3 G) }( \# v* [
///执行SQL统计命令得到包含记录条数的记录集
* y1 h3 P" e: M( `2 ]2 a& X m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText); , S3 q' q/ Z( ?1 \! q2 t
_variant_t vIndex = (long)0;
, V6 G' ~( c& P) V; W _variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量 * N4 z# Y1 e+ J8 T6 G
m_pRecordset->Close();///关闭记录集 3 j1 U& t' u) U! c
CString message; 9 F- P8 I, l* p: t
message.Format("共有%d条记录",vCount.lVal); % x1 `' v2 @$ i# [/ R
AfxMessageBox(message);///显示当前记录条数 8 ]( S8 J. _# r. V
, n8 T: n& s6 w/ h: R( |/ i" q _8 {. \
$ r, @4 b9 U* r4 T- X5 Z* F- m(2)利用Command对象来执行SQL命令 " i& _5 D. L$ n
_CommandPtr m_pCommand;
, p$ M- O! s. R) H" q/ w! H m_pCommand.CreateInstance("ADODB.Command");
- m% Y/ b) [/ V) T, R _variant_t vNULL; ) V* M& k9 I; @' {- w/ H4 z# F. d
vNULL.vt = VT_ERROR; ; Q7 H4 ?- `: R2 {* v
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数 3 T5 T) V+ B% M3 {: J: h* `
m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它
* l' v( s/ C! b3 y m_pCommand->CommandText = "SELECT * FROM users";///命令字串 & Z* H- z/ B% U9 W) Z% {5 T
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集
* [* i% W* [+ ^6 \. I! m
7 J* q' k) N5 t/ _在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
F; r& y. C( P+ ?1 s! R8 M, G( C* H+ p$ P& [5 y+ y& w
- t' e- K1 |' H* ^! s5 [ R(3)直接用Recordset对象进行查询取得记录集
- G x9 X* Q# A5 Q6 z+ Y- z) k例如
; Q) K) b! Y/ y( p% i0 I
4 [$ ?0 R# i$ o }7 x8 `6 M3 t m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); + @5 k# b* {5 G, C1 w; L+ |, e
. B1 Q& s* S! r3 U+ FOpen方法的原型是这样的:
" X! L$ b9 _9 i* {; F! Y' I: W& CHRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options ) ( ^7 o! t+ f4 \, \1 J
其中: ' w9 B6 l# v$ m; @( q
①Source是数据查询字符串 ) x% ^# I$ J; b1 @
②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)
3 `/ M- s$ b' d9 G③CursorType光标类型,它可以是以下值之一,请看这个枚举结构:
+ }8 V. G1 `) }$ S* A! F+ i+ Jenum CursorTypeEnum
5 R, ] u$ e5 y{ 7 P9 }9 V$ X/ h2 f' t# V$ I
adOpenUnspecified = -1,///不作特别指定
( z6 |- \: F' d: ~0 XadOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用 . H& t! ]5 P; U. q" {! }/ W
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 5 A1 v* d) c& P
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
$ f, `4 G2 E8 K& p; E' [5 Z3 [7 CadOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
$ U1 p/ J5 P$ W: [! f1 V' ` x9 n5 e6 F};
, O& V4 V3 Z2 M, q! M4 @% H; j3 _④LockType锁定类型,它可以是以下值之一,请看如下枚举结构: ) y# r2 f- [* ]8 l, t) `8 F. F
enum LockTypeEnum
7 }/ h* h8 }& {; @ f1 O2 h{
$ |& f& H1 h+ t+ S: I, C2 uadLockUnspecified = -1,///未指定 8 Q. \0 C* W% I5 Z# B" c
adLockReadOnly = 1,///只读记录集 3 J$ K+ v& t! \
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
% m2 ]2 }" Z- g- gadLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作 - r% ]) z! k' p6 ]' W
adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。 $ E) `0 M) J' J+ h" B# a0 C% r, `
};
+ u. i" w$ O+ J" n1 a- h5 `3 P⑤Options请参考本文中对Connection对象的Execute方法的介绍
* x. P! v4 `8 f2 @5 F1 f( c$ |1 x1 E2 U" W R! [# c2 p9 N' S
" L* e+ b8 r/ _【5】记录集的遍历、更新
5 J, W6 U8 I/ N根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday , [! O7 W: [* j3 f
以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。
, A+ ?+ ?$ q% S& ], k' z
]$ t! I5 Q5 k- l# M7 ~7 J1 S( `4 n( @' @# K) b/ A8 Q& c
_variant_t vUsername,vBirthday,vID,vOld;
; U T7 l9 ]/ r0 W% @, A_RecordsetPtr m_pRecordset;
. k8 L4 { C3 M: O& Sm_pRecordset.CreateInstance("ADODB.Recordset");
9 b5 c5 ]! l. D) F3 N6 Nm_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
& e' M: p' D1 p, Y0 {while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗? |# C" f" r( {9 i
{
# H8 t2 G! b7 `2 lvID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行
, T i8 q( t) U9 hvUsername = m_pRecordset->GetCollect("username");///取得username字段的值 : n, e% O H& W6 \7 S" K( i( |) v' [, k
vOld = m_pRecordset->GetCollect("old");
- C& f4 {8 g7 yvBirthday = m_pRecordset->GetCollect("birthday");
9 V6 H+ C4 |6 o, t0 i2 ~///在DEBUG方式下的OUTPUT窗口输出记录集中的记录 1 E- X L3 I) J9 | V* O5 |
if(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL) 3 S0 n& w6 W6 v; _
TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
/ r9 Y) S2 o# g; ` L. }: Xm_pRecordset->MoveNext();///移到下一条记录
4 C4 J9 g" {( n; ^/ A} / p$ n0 |: v) H4 A8 l1 q
m_pRecordset->MoveFirst();///移到首条记录 2 c n. [3 Q9 L0 q1 o+ g
m_pRecordset->Delete(adAffectCurrent);///删除当前记录 ; |: p q# G6 ~1 s% b8 H% f
///添加三条新记录并赋值
; U' Y2 I2 ^3 c6 hfor(int i=0;i<3;i++)
# @" o" W/ O0 p: R2 k{ * S: V8 i. L8 }) F$ f" L
m_pRecordset->AddNew();///添加新记录
" Z' P: ^% o8 k- z% [m_pRecordset->PutCollect("ID",_variant_t((long)(i+10))); 9 {# A& O; o% }, |
m_pRecordset->PutCollect("username",_variant_t("叶利钦"));
" x' _7 p9 B. p. h9 W8 zm_pRecordset->PutCollect("old",_variant_t((long)71));
( U8 p) ~% {+ Xm_pRecordset->PutCollect("birthday",_variant_t("1930-3-15")); " \8 w& b9 X' }8 F; `' t4 A
} 2 T$ q" K5 U4 S T9 Z8 u
m_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处 , ^, E. v. H9 {7 z( G9 w4 O
m_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄 3 I$ W( L# [0 D7 [' K
m_pRecordset->Update();///保存到库中
8 S) \) X6 G0 R) ?: n0 m5 z
7 b+ Y5 R) g5 c7 q6 o/ h【6】关闭记录集与连接 # J' z' f5 B/ J! k q% {9 o: E ^
记录集或连接都可以用Close方法来关闭
3 _+ `! |) m6 A5 a m_pRecordset->Close();///关闭记录集
0 w Q; X* A/ ]7 O4 W m_pConnection->Close();///关闭连接 1 i5 B. q- s3 r
* o) \$ ?% ~8 d: {至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。
3 V% l' s2 H; g$ \: J1 K点这里下载示例代码 3 b7 ]& N7 E! w$ o2 q
5 H# G- }2 \1 X3 P% ]: S, n后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。 |
|