|
一、ADO简介 ! `; c8 s; _9 d j$ Z
ADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。 4 I. Z5 ]2 { \# ?: F( h& w
本文示例代码 - x- }7 P! y' E, ?* t c8 x* L
& ?- d& v8 w q, d
二、基本流程
% c: n _/ L. l0 f3 b" D: U5 n* y万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
0 K2 L- f* a$ k; @0 E1 T k(1)初始化COM库,引入ADO库定义文件
( v2 E0 j2 r2 |% Z(2)用Connection对象连接数据库 & i/ V- j0 t. Z2 ]8 F/ u
(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。 ) y/ u# d7 g: j
(4)使用完毕后关闭连接释放对象。 ; C$ w) h1 r5 F/ |! g1 F: X$ b4 E
3 W" [' u7 d/ R- @+ D- I准备工作:
1 J* v" @& R$ q6 \为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。
8 n9 O" Z8 Y3 x, s& O3 T下面我们将详细介绍上述步骤并给出相关代码。
2 e5 n# V' ]! y, X; ?4 F# E) ~, A【1】COM库的初始化
# V0 p) f- l8 W我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码: - b" A* O5 E1 x, L
+ ^3 B Y' H' ]# d! P& ~
; D& \/ E* Y4 t; [8 j$ T( n. Q* lBOOL CADOTest1App::InitInstance() ) g' v1 }9 ]& B; x$ a6 ?
{ 1 D8 P, {/ L0 s3 U' o8 ^+ O% ]) H
AfxOleInit();
2 z+ D( x7 n, { ...... 6 R4 m- ?4 y( `0 A1 }% N4 N
8 P& H1 H+ j; Z( m6 K( z9 |9 R% z1 K【2】用#import指令引入ADO类型库
* |+ w/ c U( _我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到) ( H7 p; z1 D- i3 x
#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF")
+ Z' L: f6 p8 W& ^2 x. b这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。
! Y& } |! h) s4 c2 j$ `! B0 b$ T
几点说明: / k3 C4 g1 v7 X' ^( N1 y5 L
(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改
, u! D8 c2 n4 u0 H) F4 m& c+ v ^: J(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。 9 m; n. O- H. E+ G5 k- r' A' G9 z
msado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned
* [7 U2 c2 w+ A5 R) s' P5 n( o2 o( ~5 r
【3】创建Connection对象并连接数据库 $ H% P9 i/ J# _) R) v
首先我们需要添加一个指向Connection对象的指针:
^; ]1 N5 k6 s3 A2 s: \_ConnectionPtr m_pConnection;
( I, ~, e+ ]- E8 C4 E$ ]( V( a下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。 $ O$ }% E; ?$ X' Y
2 c% a, g- F2 c
) k5 R( A/ t! tBOOL CADOTest1Dlg::OnInitDialog()
, T# \) B) g9 D6 X4 ~9 g e/ s. z { ; @4 m) m( i+ W" T+ C0 e
CDialog::OnInitDialog(); 4 t! j$ W0 ?# G- g2 ` j
HRESULT hr; $ t) m% _- f& h0 k! X. T: q9 Y
try
: v' P8 k# D _3 q1 K! k. { { ( p. C+ M* c/ |7 Q6 f' t
hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象 7 R- V% t- D: f( N+ n5 }3 y, H- n
if(SUCCEEDED(hr)) * d0 X5 i- C& @0 q$ ~0 u) `
{
9 c% ]. P5 m' H1 _( _ hr = m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库
8 n. \; Y$ I8 |8 j& p ///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为 rovider=Microsoft.Jet.OLEDB.3.51; } ( d2 i- q5 |0 ?
}
1 p5 H. }0 {# @5 |; M, M# C catch(_com_error e)///捕捉异常
' A9 A" j- [! e6 p- A! L { # u6 w5 z- V4 R2 Y; \& v7 D- U Y" j
CString errormessage;
6 X/ a! o/ D& b7 [5 }: ^* G$ g errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage());
. b" _1 F! w+ k AfxMessageBox(errormessage);///显示错误信息 " ~5 z$ U3 _9 f. Z& ~' f! S! I# U* G
}
1 B5 [4 k( \( {% c2 p1 ]* e2 B6 g/ W
在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型
1 l: H7 L( B6 D2 H# y8 nHRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options ) - O) X$ {+ f; C( I
ConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权, 7 S3 y1 K5 H3 y6 Z
Options可以是如下几个常量: ! _3 L7 d% q4 G- z6 |
adModeUnknown:缺省。当前的许可权未设置 ) g6 N% g3 |- }3 R- a1 ]( n
adModeRead:只读
* B2 h$ a. C# R, ]adModeWrite:只写 8 E" J9 `7 L; P- ^
adModeReadWrite:可以读写 - h9 Z" z: D; q
adModeShareDenyRead:阻止其它Connection对象以读权限打开连接
) c5 p, `' e RadModeShareDenyWrite:阻止其它Connection对象以写权限打开连接 - Y8 ?& y/ b1 P/ u* f
adModeShareExclusive:阻止其它Connection对象打开连接 6 s( @9 q; v. f/ b" a, C: p6 h
adModeShareDenyNone:允许其它程序或对象以任何权限建立连接 ; K2 O! ^" y5 D" a! g+ r
7 ^0 k# _: ?( z$ C4 e! Z6 U
我们给出一些常用的连接方式供大家参考:
# ]* s/ ~+ o! d(1)通过JET数据库引擎对ACCESS2000数据库的连接
( u6 s6 i, T& @; o% J9 F( h4 }5 C, f m1 |. \% ^
m_pConnection->Open(" rovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown); `. Y5 v2 Y0 o* C) p( s
/ P9 E/ i9 G! _* D5 @* j(2)通过DSN数据源对任何支持ODBC的数据库进行连接: 0 K: Z, E+ u) S* d+ E* G
m_pConnection->Open("Data Source=adotest;UID=sa WD=;","","",adModeUnknown);
1 ]6 _! f2 B3 M7 y$ ?6 t0 p
3 ^4 ~% [# J: F1 Y9 P& J! z(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown); 7 i! D: o! B; [4 X6 E
3 {4 {3 Y# M! G! y z+ d
其中Server是SQL服务器的名称,DATABASE是库的名称 0 A6 o( l& h+ ~1 C; Z
+ L2 k# ]) _% P- `4 x! v5 {
Connection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
6 s7 l; A0 n$ ^! O2 ?# TConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
9 T5 V1 {, [+ a2 r& x0 k$ Rm_pConnection->Open("Data Source=adotest;","","",adModeUnknown); & y% v6 H$ B# @* N" D6 m
! T5 U( @0 l3 }# z2 H( A$ J" m- K& U
State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:
* e; R9 l, X( bif(m_pConnection->State) 2 v8 |6 S7 h# y( C1 v1 L
m_pConnection->Close(); ///如果已经打开了连接则关闭它
- i5 @# q R' E% N: G$ G& X- h% ^, ?/ C4 L! ^
( ?6 s. o' c7 ~& K5 @) G$ n【4】执行SQL命令并取得结果记录集 ; _% l8 q/ z3 I2 \
为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset;
6 L; m6 D( U) a2 A! b) |9 t# D并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset"); / S: ~1 D! K' U" q: t9 r
SQL命令的执行可以采用多种形式,下面我们一进行阐述。 }: a0 `, }0 U
$ Q7 J1 a" X) E- A0 ]$ w, z) y( h
(1)利用Connection对象的Execute方法执行SQL命令 0 Q2 `' `) @/ F& ]4 n
Execute方法的原型如下所示:
7 F+ K. A% Z+ I- K_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一: & e; @- \- a7 S4 }( f. s x5 j5 L
adCmdText:表明CommandText是文本命令 9 Y7 M3 V! v4 X) [
adCmdTable:表明CommandText是一个表名 7 t8 M7 G6 X% j7 j$ V8 Z- ^% N
adCmdProc:表明CommandText是一个存储过程
$ B; Z( y- v* h2 z) J! O& FadCmdUnknown:未知 ; W/ k) s2 X. \$ ^+ E0 m7 z
6 F! j" _/ t) }+ r' L
Execute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。 _variant_t RecordsAffected;
( ?8 q4 e9 T4 R f0 `1 r, \" r ///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday
7 Y: U$ R2 S }7 e! {9 E m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); & ^3 V4 D. H4 C" m- x2 c$ J
///往表格里面添加记录 : d& t7 l) x1 f, n+ ^
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText); . i$ S4 h/ B5 A2 y$ |) T
///将所有记录old字段的值加一 / t: x* ^4 L* _3 [. h
m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
/ \! m) j) l6 m$ G ///执行SQL统计命令得到包含记录条数的记录集
4 T% K1 W& I( l9 V, g0 l m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
) v! P2 R) Z! n( g) a _variant_t vIndex = (long)0; 0 d/ }- m3 {- f' {3 I
_variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
G2 C2 u! ^9 a' B9 G/ C m_pRecordset->Close();///关闭记录集 8 a) i& _7 X5 F9 F9 E6 q5 P
CString message; 3 l3 g" w9 k5 O. U) s N! [2 T
message.Format("共有%d条记录",vCount.lVal); 5 _# O; {. y; g6 \: z+ C3 q
AfxMessageBox(message);///显示当前记录条数 $ j5 {& l* P+ p: U3 E
$ V& v' t2 V' x2 o/ t' Y ^5 ~4 v& K$ x/ ^0 ]9 ^
(2)利用Command对象来执行SQL命令
2 |) k5 v# g7 }4 h _CommandPtr m_pCommand; % b/ x, F5 u; g/ L+ d. e K$ g& I
m_pCommand.CreateInstance("ADODB.Command"); 8 u: s; c, `5 U/ `2 s/ Z& t. m
_variant_t vNULL; ; ~" e& }7 ^) L2 F) R
vNULL.vt = VT_ERROR; . L% q' t3 E/ _! f
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数 9 f7 R6 b: s2 S7 h: C' i
m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它 : f6 w/ f5 t$ X% b) b7 x$ n
m_pCommand->CommandText = "SELECT * FROM users";///命令字串
, T, R- X6 D6 l m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集
3 g% t) j5 v* A% n; y( I% @
& |/ Q# l2 J2 P8 U( b2 R8 e- v" y在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。 0 {; f. |7 j7 E$ b/ X, m/ W
) ]$ ?! H2 K" I6 S
) J( |0 f ~ B! o( `(3)直接用Recordset对象进行查询取得记录集
- b& R x9 [/ C! g6 K% R& V例如
6 `* J: E+ g& D6 G8 r* U1 u' C) w/ q' p
m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); 3 N9 ?2 q2 w* S" R4 O
0 @( A2 _! d% g: _7 L5 o
Open方法的原型是这样的: ) N# @) K5 o" x" ]5 M% A8 d
HRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )
1 K; l( Y) z0 x3 {$ D$ c1 w/ M& s& F& p其中:
3 R {6 x5 N: k& j- q0 z$ F% B①Source是数据查询字符串
2 k! s6 i8 ~* E1 v( ^②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)
. j2 h0 n( g: U8 X7 k③CursorType光标类型,它可以是以下值之一,请看这个枚举结构:
2 r! h b/ D! W) k* uenum CursorTypeEnum 2 r' k F, ~7 X& [# q
{
1 ^# q) l" C4 n: f/ DadOpenUnspecified = -1,///不作特别指定 # |0 J, n/ ~- T) Y
adOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
( [' l4 b( o8 J, K8 _adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。 8 ^' o' N. {% P& u3 P Q; ~1 a
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。 & J$ P6 x9 Q' s9 b# u2 ]
adOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
6 f; b! a6 H+ W/ Q8 _};
2 j G( ^5 o, Z3 Z& y7 G+ d) I④LockType锁定类型,它可以是以下值之一,请看如下枚举结构: " x, W3 [) `' L# Y* L/ Z3 q
enum LockTypeEnum 6 Y( _# [) R( k! N/ u
{ % S/ N1 S- m, t- s- s7 k
adLockUnspecified = -1,///未指定
% {' c/ {3 y6 k8 X; @3 @adLockReadOnly = 1,///只读记录集 " O6 h+ H6 ~/ S+ Y T0 d; `
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
$ H$ D! C- R. w; a6 |5 kadLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作 / x- c7 L. y+ f
adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。 + T# I2 T8 }* i( o0 _
}; 0 M4 s1 C0 ^) ?
⑤Options请参考本文中对Connection对象的Execute方法的介绍
6 | F; J7 G* B1 }3 b5 D5 k% h: L0 ?, B' p) k; \* O
$ i' }3 u1 P& q' t
【5】记录集的遍历、更新 + o, D/ @1 \0 N' K4 i
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday
4 ~" d `* v$ ^( {, [( w( f) `5 X0 J以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。 : G5 b5 J" n$ x
$ ~# M/ V4 |2 x; K7 {5 l
+ s: s! G+ K Q7 @3 {2 n, H! b0 L_variant_t vUsername,vBirthday,vID,vOld; & a h2 G4 p. b: G" x
_RecordsetPtr m_pRecordset; : d9 g; Y2 u% g6 W; e* P
m_pRecordset.CreateInstance("ADODB.Recordset");
0 X$ u) }: y9 b5 xm_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText); & k! I( v- U# `6 P
while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗? , R' l4 @- U# C- x2 C
{ % D& @7 v8 h9 I3 g
vID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行 " Z$ h5 v: o* U, ~8 Q6 U0 Y$ V
vUsername = m_pRecordset->GetCollect("username");///取得username字段的值
5 k7 I" r* q: J- |: e( fvOld = m_pRecordset->GetCollect("old");
% W& t- P% j, j' kvBirthday = m_pRecordset->GetCollect("birthday"); ( r5 G) S% n) K& n( n
///在DEBUG方式下的OUTPUT窗口输出记录集中的记录
3 `- D/ F* N# f5 V/ ~* z& Qif(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL) 8 I; T/ t3 ? ^8 p- x% |
TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
* ]2 l H5 k. Q' `7 r: v/ Bm_pRecordset->MoveNext();///移到下一条记录 6 X. r$ }* H2 z: u) o3 h# Z
} * B0 |: U1 _' A
m_pRecordset->MoveFirst();///移到首条记录
5 }1 Y9 `/ W9 em_pRecordset->Delete(adAffectCurrent);///删除当前记录 7 d6 N5 x' q! U$ M5 }6 N1 v8 i
///添加三条新记录并赋值 ; m: k" u; x% ]: g
for(int i=0;i<3;i++) . N H! R% U0 \! h: a
{
; i. @4 R+ e* N+ v* Wm_pRecordset->AddNew();///添加新记录 " O5 H5 H$ P% W; X x
m_pRecordset->PutCollect("ID",_variant_t((long)(i+10))); + O0 O7 e; c+ A h8 D. h$ J$ `
m_pRecordset->PutCollect("username",_variant_t("叶利钦")); ( X) c6 i8 ^' U! g5 h8 @1 H
m_pRecordset->PutCollect("old",_variant_t((long)71));
; Q" H& {5 q1 P% g) I- }" Fm_pRecordset->PutCollect("birthday",_variant_t("1930-3-15"));
' D& ?! j9 N8 A}
S8 I9 [' L% E$ Gm_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处 7 b0 V& H# D: N0 S8 {
m_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄
1 w: J3 s" r9 e- P6 k) a" n3 Tm_pRecordset->Update();///保存到库中 . X+ q- a, j" Q' B
7 f" S( {8 z% b* o# @
【6】关闭记录集与连接 5 `9 M5 S4 V- @
记录集或连接都可以用Close方法来关闭
6 ^# z" F$ g% t) u3 }1 ` m_pRecordset->Close();///关闭记录集
0 H0 H. B0 W) h6 M# K m_pConnection->Close();///关闭连接
8 p3 n# ?" I+ @' ~& Q1 s6 [# ^2 d8 F( h4 E' a
至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。 / [: A' T8 Y3 n8 G7 r
点这里下载示例代码 8 U$ _% e1 p) d+ q& n5 h
$ I' @1 p/ N7 B. j$ }: {4 I6 r
后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。 |
|