找回密码
 注册
搜索
查看: 5396|回复: 0

[收藏]VC++ADO连接数据库

[复制链接]
发表于 2005-9-1 23:30:26 | 显示全部楼层 |阅读模式
  一、ADO简介 " }7 Z! ]6 z" c9 p* b6 f; I
ADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。
6 n4 A8 Q( R/ U/ j本文示例代码 1 ]0 S, W5 E' r/ U
$ N3 f' u4 A. c$ H- N
二、基本流程
; a7 ~7 K6 p$ X. \6 U* ]万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
/ e! b" l3 B3 l. {(1)初始化COM库,引入ADO库定义文件
& p$ }9 D& g( u  }, ]) B/ f(2)用Connection对象连接数据库
) a! S. e/ P# U' H' c(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。
7 l: `' t! P3 @  t- t2 v(4)使用完毕后关闭连接释放对象。
% Q* U6 X/ `$ [/ Y2 x& `% O% B3 |1 h% D* V6 H/ U; s2 O
准备工作:   |( U( }6 ]. f
为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。 . B3 C# b8 D  z/ S  {" V" _: F
下面我们将详细介绍上述步骤并给出相关代码。
$ m, O& _: o9 Z2 o【1】COM库的初始化
" c8 t7 ?/ {& x( g# P* Y; H我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码: ( U3 N# \- U8 @* g  I. q& ~
- ^+ t, f" m, x/ V  r
$ N0 k$ I6 }# t9 C% M1 Y' D$ y
BOOL CADOTest1App::InitInstance()
9 D6 a4 t) q1 `0 }  {
# o7 n+ g4 _( ]* m' }+ |* N  AfxOleInit(); 4 w) C# V5 p( @8 {- W
  ...... ' w6 c, t" v2 X7 k

+ |3 y( d* Q1 y  z. c/ e( d【2】用#import指令引入ADO类型库
, b& v8 h: W$ f* v+ N我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到)
' a, ]" ^9 i) o3 W9 h#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF")
7 e0 ]3 ^, D$ h. o3 i! X这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。
3 w: M3 [; k6 {1 }! b7 l) d
5 _+ Z1 e4 q9 N+ N几点说明:
* c6 T" ?: X. O5 u7 w(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改 2 h8 g) r- i. z8 U# @! [" a% v7 b
(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。
& N7 }' o9 j! o0 nmsado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned 5 Q% a* B/ R/ e" M
. ~- J. m% h  C/ O# C' L
【3】创建Connection对象并连接数据库
7 [" P( G+ _( ?首先我们需要添加一个指向Connection对象的指针:
4 m5 ?% P# S3 k% q8 p_ConnectionPtr m_pConnection; ; ~+ G/ [( u% A, v
下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。 2 x& k) ?# z9 L0 |4 N
# T8 }# E2 ~' f6 y

! q& h6 d0 f( c( h; k9 b4 q: GBOOL CADOTest1Dlg::OnInitDialog() - b: `( l! b2 q1 j
  {   L7 d; @& z- n  o4 i
  CDialog::OnInitDialog();
/ k0 a; x+ s  P5 X4 ?9 y  HRESULT hr;
; W! Y  t& ]1 y) U) H( T7 g  try
  K* p, ~# r. w! \  { ' R1 v9 c9 E) G# }* n
  hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象
8 |7 w( ^3 l# q3 a" z7 X0 c  if(SUCCEEDED(hr)) 7 `" s9 ^& `6 [2 {0 O9 w! b+ `
  {
) u' D. c  L9 F8 G+ g$ ]$ F& `8 H  hr = m_pConnection->Open(&quotrovider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库 % m  O2 P5 i) E+ Q
  ///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为rovider=Microsoft.Jet.OLEDB.3.51;  }
; I( \/ H4 C& c' y, Y0 p( d1 X  } 1 u. O+ R$ k1 [5 r% V
  catch(_com_error e)///捕捉异常
6 h: ~) h/ q& B8 l  {
( [6 _, t- a  d, N/ Q3 e* T  CString errormessage; ; P) G, a/ }( _1 O" e- C2 b. a
  errormessage.Format("连接数据库失败!\r\n错误信息:%s",e.ErrorMessage()); : m  X0 d8 y2 f8 `# T
  AfxMessageBox(errormessage);///显示错误信息
# j4 J8 H, x: g% C" G  Z: d  } % r, C; x/ N9 ]1 J$ n3 O, W
6 y( g# N2 y7 x9 n/ s: R1 N/ L" e
在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型 9 C! a9 x# u, X" Q. l
HRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options ) " s+ l* j- c  z  j( B0 x: O9 A
ConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权,
* U0 ]8 J8 _& r' [; ~& ROptions可以是如下几个常量: % V  }' y' w8 Y1 E; H6 [
adModeUnknown:缺省。当前的许可权未设置
+ F3 ?) f# g1 \$ ZadModeRead:只读
; j- B8 I# o/ Y. x- LadModeWrite:只写 # X" @1 k% _8 d: ^3 t
adModeReadWrite:可以读写 ' ]& h% A2 e, y9 @
adModeShareDenyRead:阻止其它Connection对象以读权限打开连接
4 l  S  _: E8 E0 a' PadModeShareDenyWrite:阻止其它Connection对象以写权限打开连接
# G! v8 ?! N# madModeShareExclusive:阻止其它Connection对象打开连接 ! q) X: s* i% x
adModeShareDenyNone:允许其它程序或对象以任何权限建立连接
& d" H! u# T' `. L1 L8 l) X" z& t8 A* u. h) W
我们给出一些常用的连接方式供大家参考:
; S8 |/ }2 d2 y. |+ P! Z; X5 X(1)通过JET数据库引擎对ACCESS2000数据库的连接
# }! L  L2 R. {% ]+ l# Z0 X
  k- e) l. R( t3 M6 j( K4 km_pConnection->Open(&quotrovider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown); - E# g5 r8 ^. J7 e* V9 l- Q& r! \

/ G2 N2 \6 T  O5 W. E4 u(2)通过DSN数据源对任何支持ODBC的数据库进行连接:
0 K3 D" j9 w8 j. bm_pConnection->Open("Data Source=adotest;UID=saWD=;","","",adModeUnknown);
! V9 g* \& S9 [% R' L$ R( v. r/ ]7 A' @6 q
(3)不通过DSN对SQL SERVER数据库进行连接: m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown);
, L' d" V6 M: I2 ?3 ~# P: L
2 v# B# Q5 I, ~其中Server是SQL服务器的名称,DATABASE是库的名称 1 i, x+ b, `2 T

1 Q; q8 Z0 m$ F/ xConnection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
- ^! d6 U# i1 }5 }ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如: m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
: O0 S! E% f; o0 A0 N+ c: wm_pConnection->Open("Data Source=adotest;","","",adModeUnknown); 0 ~8 K/ {- y+ _; S$ ^9 m
3 t* q, n8 a/ u7 D5 B

8 s6 A8 k" E1 M% }( m9 Q) I  y6 BState属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:
8 I  E5 c/ |0 K- q3 H5 ^, Q, Dif(m_pConnection->State)
! s' P6 G9 M! t! L4 m* \     m_pConnection->Close(); ///如果已经打开了连接则关闭它
8 l4 f* H* J5 v& c: s4 Y% L/ H2 ]) @$ y2 f3 x

/ j3 F9 e5 H$ l【4】执行SQL命令并取得结果记录集
) Q( I# |& T+ w0 V( b* A& W为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset; : k- b) T, ?6 r8 X/ b4 u# R& i
并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset");
. c+ q, m8 V( m) DSQL命令的执行可以采用多种形式,下面我们一进行阐述。
; Y) Z" I* m% v/ B8 N+ C$ W1 c. ]7 P% X- W& o
(1)利用Connection对象的Execute方法执行SQL命令
) u* x, x) g$ g# i0 RExecute方法的原型如下所示: ) v" R9 G+ d1 v
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一: 2 Q" @- U( v7 N3 m2 ?& {: h
adCmdText:表明CommandText是文本命令 2 T. c1 \7 T4 Z* H+ k( m, D
adCmdTable:表明CommandText是一个表名
$ L6 r: B  d9 }! b7 QadCmdProc:表明CommandText是一个存储过程 3 m1 n1 Q3 T, G# R, D% D* Q: ]. {, p3 n
adCmdUnknown:未知 7 t2 u: j, L. D, u
2 m, k- v5 I- P* V" a4 B. F
Execute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。   _variant_t RecordsAffected;
! }+ X8 b, E/ ]  j  ///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday
- w. C& ~5 s2 d; y0 y3 b' Y, u  m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText); ' C) Z  k5 s1 o3 L3 R4 d
  ///往表格里面添加记录
4 K/ @8 H1 s! o* U  m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) valueS (1, nullnullnullnullnullnullnullnullWashingtonnullnullnullnullnullnullnullnull,25,nullnullnullnullnullnullnullnull1970/1/1nullnullnullnullnullnullnullnull)",&RecordsAffected,adCmdText); ' u9 V  Z; }7 Q* Z8 U( J
  ///将所有记录old字段的值加一 # I& r7 p& v: P( ]$ N$ Q
  m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText); ' w: }* |$ ?: p/ i
  ///执行SQL统计命令得到包含记录条数的记录集 . J* k9 [" o3 P$ ^
  m_pRecordset =  m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
0 ~7 q3 U0 @6 G- W/ u: |  _variant_t vIndex = (long)0; 8 h* [3 S0 a7 K& _6 F
  _variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
: c) J* F! p8 c2 i; ^  m_pRecordset->Close();///关闭记录集 ) T9 B: i8 ^: ]6 z9 D! ~
  CString message; ) j2 B3 f" z3 z
  message.Format("共有%d条记录",vCount.lVal);
$ P+ ]. C8 c) o  AfxMessageBox(message);///显示当前记录条数 ' `0 S1 x: f0 M0 |" M

: X5 _$ |; M, h, }) I5 b
" ~9 U! @  C7 m3 E(2)利用Command对象来执行SQL命令 * F) \; q# Q4 k8 Q; A. {" M
  _CommandPtr m_pCommand;
6 A. |  `5 T+ ^+ \$ Y2 x  m_pCommand.CreateInstance("ADODB.Command"); & d: G& y$ |: e2 |8 l' x" z2 H
  _variant_t vNULL; + a3 s) @* M- J& m  u1 A/ M" W
  vNULL.vt = VT_ERROR;   W4 F( V  w6 }
  vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数 8 C9 D8 l8 x5 p1 M. T8 M1 U
  m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它
9 ?  Z) r) U- K5 A' H  m_pCommand->CommandText = "SELECT * FROM users";///命令字串
- P7 W6 r; o9 f0 O  x  m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集 3 Q- }# {  K0 q" l- |

# ^' `" `# R; [3 z! U# p在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。 : B* r" a% _, X6 b1 ^' b
* R' m8 y& T% O0 C; ^* I

9 z+ \2 R6 ~4 ~( O. g) Z(3)直接用Recordset对象进行查询取得记录集
* N& `* F4 K( y例如
% }9 \  j; R& M8 z4 f8 k$ @/ A2 T1 v; i& ^* y0 ^
  m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
2 `7 C6 V' p* A- `% m$ W6 s
& ~* W4 W8 U) `" d2 X: TOpen方法的原型是这样的:
5 R! e7 u  |) P" a: x+ tHRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )
, {6 ^. g0 j& X5 z, N8 W1 l1 G0 d" B7 O其中: 4 M: Q3 O+ v' M) @
①Source是数据查询字符串
1 P3 C) h" P3 ?②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象) + U# n% ]. n# q  l$ c" I8 _
③CursorType光标类型,它可以是以下值之一,请看这个枚举结构: ) N7 g; I: w6 F1 K/ }
enum CursorTypeEnum
7 G1 W* C8 G9 ?# e{ ) T! j( o( d2 w0 Q6 Q0 ]
adOpenUnspecified = -1,///不作特别指定
" J3 v; n) f0 N1 o" L# M% ZadOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
+ D2 e; o5 m& J& S6 EadOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。
0 X/ W2 K2 u1 ?5 nadOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
" T5 X1 i8 c1 g; C- Q1 zadOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
( S4 i6 |! k& e! k& g1 D% M# v};
% X6 b* S4 P) x# f6 N5 W④LockType锁定类型,它可以是以下值之一,请看如下枚举结构:
- r& j1 r1 Q, C# j4 I1 ~$ Fenum LockTypeEnum 5 C) k  R$ ?. k! m! @- c
{ 3 T" s0 |1 \2 U! m% F3 G4 U4 ~% p9 U+ T
adLockUnspecified = -1,///未指定
. O$ B7 h/ T0 z9 x& AadLockReadOnly = 1,///只读记录集 . H+ W/ y7 u5 \2 F9 i8 \4 ?/ B
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
2 ]3 ~. e2 N: M" i* J$ C2 a; I. `adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
6 L- W; q5 o! F8 x; c7 BadLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。 ( V! g) Q; h; k7 V; f9 y' p
}; 0 _. R$ _& m4 b5 M, x
⑤Options请参考本文中对Connection对象的Execute方法的介绍 4 g8 r' o" k/ [- D

' h8 x. v! Q( u4 j  b8 V0 v3 c
9 ^2 ]0 j8 n6 ]【5】记录集的遍历、更新 ! o" _% ~  _# K) K$ i" p
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday ' n$ Y( U. X* b% `! ?
以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。
$ e9 e7 z* u- A- l
/ p) v- v8 E3 T5 N0 S; Z4 b& t$ c. D* |3 W  R% u/ l$ L
_variant_t vUsername,vBirthday,vID,vOld; ( P0 m$ U& c8 h7 o4 f" F5 h. \: _
_RecordsetPtr m_pRecordset;
/ R  H4 m) {' M8 W: J1 l3 Lm_pRecordset.CreateInstance("ADODB.Recordset");
& U) b2 Q+ T4 Q! Km_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
. G! j: J+ Z4 f  ]while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗? / y; Y1 O! H0 L; I1 V4 ?, j
{
& j, f1 n  I( h6 F+ @. i) XvID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行 , F' f) q( ~0 g2 g* U/ a' a
vUsername = m_pRecordset->GetCollect("username");///取得username字段的值 ; M2 ~9 M  e3 U- Q
vOld = m_pRecordset->GetCollect("old");
8 C# [. R# c: A  b2 mvBirthday = m_pRecordset->GetCollect("birthday");
! V% I2 M; l& d7 x* k- j///在DEBUG方式下的OUTPUT窗口输出记录集中的记录
! `. a0 J& y2 E8 Q. ~. `) Nif(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL) " U3 X' f+ |" F# j1 l, p
  TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
8 m% x# q8 K1 h& `! q, m4 qm_pRecordset->MoveNext();///移到下一条记录
. G( G! M7 O% q6 O+ q" [0 v) v}
; k5 p5 D" l* h: _0 S  j. Z0 ym_pRecordset->MoveFirst();///移到首条记录 5 E4 m) p+ \3 G- A( |2 o+ z9 j5 J
m_pRecordset->Delete(adAffectCurrent);///删除当前记录 0 \8 z8 X9 o5 Q8 s0 S
///添加三条新记录并赋值
5 B% Y( I# `4 C: v5 l, e! Xfor(int i=0;i<3;i++)
2 B$ y7 Z( p' @. W, }{
- h: a7 X. q* K3 f8 Um_pRecordset->AddNew();///添加新记录
. k) x- _1 J6 A/ Z2 z8 `m_pRecordset->PutCollect("ID",_variant_t((long)(i+10))); * c8 m7 D, [5 }: P3 s
m_pRecordset->PutCollect("username",_variant_t("叶利钦")); 5 v6 G+ D  G$ R# [
m_pRecordset->PutCollect("old",_variant_t((long)71)); / z  G% F5 }/ H& o2 t0 T8 \+ D
m_pRecordset->PutCollect("birthday",_variant_t("1930-3-15")); : v" z9 v$ q3 _, m9 m' x- P
}
# Z9 u. l8 B9 o  H; U, X4 i2 O$ wm_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处 7 K( E3 E* F- l9 Y$ h
m_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄 3 r7 B& o7 ]/ D  Y2 O3 E( u
m_pRecordset->Update();///保存到库中 , {0 L. _2 q# H

+ M( _/ f0 K. s: E2 O7 f1 M" x: f! \3 z) U【6】关闭记录集与连接
' V: v$ ?2 k+ t& y记录集或连接都可以用Close方法来关闭 $ l0 j3 q) q0 Z& i$ c
     m_pRecordset->Close();///关闭记录集 5 A( a/ Y- O6 v; ^
     m_pConnection->Close();///关闭连接 1 Q3 o& E; i/ r' H

) `0 @' o) N( P+ V; I至此,我想您已经熟悉了ADO操作数据库的大致流程,也许您已经胸有成竹,也许您还有点胡涂,不要紧!建议你尝试写几个例子,这样会更好地熟悉ADO,最后我给大家写了一个小例子,例子中读出所有记录放到列表控件中、并可以添加、删除、修改记录。   Z: d& Y& Z8 F/ z
点这里下载示例代码 ) }+ l* }8 U8 t: H: O5 [$ ?

7 Z. E" J$ f/ ?) n后记:限于篇幅ADO中的许多内容还没有介绍,下次我们将详细介绍Recordset对象的属性、方法并解决几个关键的技术:绑定方式处理记录集数据、存储过程的调用、事务处理、图象在数据库中的保存与读取、与表格控件的配合使用等。
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Archiver|手机版|小黑屋|宁德市腾云网络科技有限公司 ( 闽ICP备2022007940号-5|闽公网安备 35092202000206号 )

GMT+8, 2025-11-14 18:13 , Processed in 0.020623 second(s), 15 queries .

Powered by Discuz! X3.5

© 2001-2025 Discuz! Team.

快速回复 返回顶部 返回列表