分享

ADO接口简介

 笔录收藏 2015-05-28

1. 百度文库:http://wenku.baidu.com/view/8e2e99ecf8c75fbfc77db230.html

2. CSDN:http://blog.csdn.net/augusdi/article/details/7005597

接口概述:

ADO库包含三个基本接口:_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。

(1) _ConnectionPtr接口返回一个记录集或一个空指针

通常使用它来创建一个数据连接 或 执行一条不返回任何结果的SQL语句,如一个存储过程。

(使用_ConnectionPtr接口返回一个记录集不是一个好的使用方法)

通常同Cdatabase一样,使用它创建一个数据连接,然后使用其它对象执行数据输入输出操作。

(2) _CommandPtr接口返回一个记录集

它提供了一种简单的方法来执行返回记录集的存储过程和SQL语句

在使用_CommandPtr接口时,你可以利用全局_ConnectionPtr接口,也可以在_CommandPtr接口里直接使用连接串。

如果你只执行一次或几次数据访问操作,后者是比较好的选择。

但如果你要频繁访问数据库,并要返回很多记录集,那么,你应该使用全局_ConnectionPtr接口创建一个数据连接,

然后使用_CommandPtr接口执行存储过程和SQL语句。

(3) _RecordsetPtr是一个记录集对象

与以上两种对象相比,它对记录集提供了更多的控制功能,如记录锁定,游标控制等。

同_CommandPtr接口一样,它不一定要使用一个已经创建的数据连接,

可以用一个连接串代替连接指针赋给_RecordsetPtr的connection成员变量,让它自己创建数据连接。

如果你要使用多个记录集,最好的方法是同Command对象一样使用已经创建了数据连接的全局_ConnectionPtr接口,然后使用_RecordsetPtr执行存储过程和SQL语句

使用步骤:

1> 引入ADO类

#import "c:\program files\common files\system\ado\msado15.dll"  no_namespace rename ("EOF", "adoEOF")

其作用同我们熟悉的#include类似,编译的时候系统会为我们生成 msado15.tlh、ado15.tli 两个C++头文件来定义ADO库。

在 #import "" 引入ADO之后就可以用3个智能指针了:_ConnectionPtr、_RecordsetPtr和_CommandPtr

2> 初始化COM库,引入ADO库定义文件

在MFC中可以用  AfxOleInit();

非MFC环境中用  CoInitialize(NULL);/ CoUnInitialize();

3> 用Connection对象连接数据库

首先我们需要添加一个指向Connection对象的指针:

  1. _ConnectionPtr m_pConnection;  
  2. HRESULT hr = m_pConnection.CreateInstance("ADODB.Connection");//创建Connection对象  
  3. if(SUCCEEDED(hr))  
  4. {  
  5.     try  
  6.     {  
  7.         hr = m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);//连接数据库  
  8.     }  
  9.     //COM错误取得,当执行COM功能的时候,如果出错,可以捕捉到_com_error的异常  
  10.     catch (_com_error e)   
  11.     {    
  12.     }  
  13. }  

在这段代码中我们是通过Connection对象的Open() 方法来进行连接数据库的,下面是该方法的原型:

HRESULT Connection::Open (_bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options )

参数:

ConnectionString 为连接字串,

UserID    是用户名,

Password  是登陆密码,

Options    是连接选项,用于指定Connection对象对数据的更新许可权, 

Options可以是如下几个常量:

    adModeUnknown:  缺省。当前的许可权未设置
    adModeRead:    只读
    adModeWrite:  只写
    adModeReadWrite:  可以读写
    adModeShareDenyRead: 阻止其它Connection对象以读权限打开连接
    adModeShareDenyWrite: 阻止其它Connection对象以写权限打开连接
    adModeShareExclusive: 阻止其它Connection对象打开连接
    adModeShareDenyNone: 允许其它程序或对象以任何权限建立连接

补充:常用的数据库连接方法:

(1) 通过JET数据库引擎对ACCESS2000数据库的连接

m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown);

(2) 通过DSN数据源对任何支持ODBC的数据库进行连接

m_pConnection->Open("Data Source=adotest;UID=sa;PWD=;","","",adModeUnknown);

//m_pConnection->Open("DSN=test;","","",0);  //连接叫作test的ODBC数据源\

(3) 不通过DSN对SQL SERVER数据库进行连接: 

m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=13Array","","",adModeUnknown);

其中Server是SQL服务器的名称,DATABASE是库的名称

Connection对象中两个有用的属性:ConnectionTimeOut与State

其中:ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如:   

  1. //设置超时时间为5秒  
  2. m_pConnection->ConnectionTimeout = 5;   
  3. m_pConnection->Open("Data Source=adotest;","","",adModeUnknown);  

            State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:

  1. //如果已经打开了连接则关闭它  
  2. if(m_pConnection->State)  
  3. {  
  4.      m_pConnection->Close();  
  5. }   

4> 利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记 录集进行查询、处理

SQL命令的执行可以采用多种形式,下面我们一进行阐述。

(1)  利用Connection对象的Execute方法执行SQL命令

Execute方法的原型如下所示:

_RecordsetPtr Connection::Execute (_bstr_t CommandText, VARIANT * RecordsAffected, long Options )

参数:

CommandText  是命令字串,通常是SQL命令;
RecordsAffected  是操作完成后所影响的行数;
Options    表示CommandText中内容的类型,Options可以取如下值之一:
      adCmdText:表明CommandText是文本命令
      adCmdTable:表明CommandText是一个表名
      adCmdProc:表明CommandText是一个存储过程
      adCmdUnknown:缺省。当前的许可权未设置

Execute执行完后返回一个指向记录集的指针_RecordsetPtr,下面我们给出具体代码并作说明。  

  1. try  
  2. {  
  3.     _variant_t ra;  
  4.   
  5.     m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM 学生信息", &ra, adCmdText);   
  6.      //取得第一个字段的值放入vCount变量  
  7.     _variant_t vCount = m_pRecordset->GetCollect((_variant_t)(long)(0));  
  8.   
  9.     m_pRecordset->Close();   
  10.       
  11.     CString message;  
  12.     message.Format("共有%d条记录",vCount.lVal);  
  13.     AfxMessageBox(message);    
  14. }  
  15.   
  16. catch (_com_error e)   
  17. { ...}  

(2)利用 Command对象来执行SQL命令


  1. try  
  2. {     
  3.     _CommandPtr m_pCommand;   
  4.     m_pCommand.CreateInstance("ADODB.Command");  
  5.     
  6.     //关键的一句,将建立的连接赋值给它  
  7.     m_pCommand->ActiveConnection = m_pConnection;   
  8.     m_pCommand->CommandText="SELECT COUNT(*) FROM userInfo";  
  9.     //执行文本命令  
  10.     m_pRecordset=m_pCommand->Execute(NULL, NULL, adCmdText);  
  11.   
  12.     _variant_t vCount = m_pRecordset->GetCollect((_variant_t)(long)0); //取得第一个字段的值  
  13.     
  14.     CString str;  
  15.     str.Format("共有%d条记录",vCount.lVal);  
  16.     AfxMessageBox(str);    
  17.   
  18.     m_pRecordset->Close();   
  19. }  
  20. catch (_com_error e) {...}  

在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。

(3) 直接用Recordset对象进行查询取得记录集 

  m_pRecordset->Open("SELECT * FROM 学生信息",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);

Open方法的原型是这样的:

HRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )

参数:

1> Source是数据查询字符串

2> ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)

3> CursorType光标类型,它可以是以下值之一,请看这个枚举结构:
  enum CursorTypeEnum
  {
    adOpenUnspecified = -1, //不作特别指定
    adOpenForwardOnly = 0, //前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
    adOpenKeyset = 1,  //采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。
    adOpenDynamic = 2,  //动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
    adOpenStatic = 3  //静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
  };
4> LockType锁定类型,它可以是以下值之一,请看如下枚举结构:
  enum LockTypeEnum
  {
    adLockUnspecified = -1,  //未指定
    adLockReadOnly = 1,  //只读记录集
    adLockPessimistic = 2,  //悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
    adLockOptimistic = 3,  //乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
    adLockBatchOptimistic = 4, //乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。
  };


5> 使用完毕后关闭连接,释放对象。


(3) 执行SQL命令并取得结果记录集

为了取得结果记录集,我们定义一个指向Recordset对象的指针: _RecordsetPtr  m_pRecordset;

1. m_pRecordset.CreateInstance("ADODB.Recordset");


(4) 记录集的遍历、更新

根据我们刚才通过执行SQL命令建立好的 学生信息 表,它包含四个字段:学号,姓名,年龄,生日

以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。

  1. try  
  2. {  
  3.     _variant_t vUsername,vBirthday,vID,vOld;  
  4.     _RecordsetPtr m_pRecordset;  
  5.       
  6.     m_pRecordset.CreateInstance("ADODB.Recordset");  
  7.       
  8.     m_pRecordset->Open("SELECT * FROM 学生信息",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);  
  9.   
  10.     while(!m_pRecordset->adoEOF)   
  11.     {  
  12.         //取得第1列的值,从0开始计数,也可以直接给出列的名称,如下一行  
  13.         vID = m_pRecordset->GetCollect(_variant_t((long)0));  
  14.         //取得姓名字段的值  
  15.         vUsername = m_pRecordset->GetCollect("姓名");  
  16.         vOld = m_pRecordset->GetCollect("年龄");  
  17.         vBirthday = m_pRecordset->GetCollect("生日");  
  18.     
  19.         //在DEBUG方式下的OUTPUT窗口输出记录集中的记录  
  20.         TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r\n", vID.lVal, (LPCTSTR)(_bstr_t)vUsername, vOld.lVal, (LPCTSTR)(_bstr_t)vBirthday);    
  21.   
  22.         //移到下一条记录  
  23.         m_pRecordset->MoveNext();      
  24.     }  
  25.     
  26.     //移到首条记录  
  27.     m_pRecordset->MoveFirst();      
  28.     //删除当前记录  
  29.     m_pRecordset->Delete(adAffectCurrent);      
  30.     
  31.     //添加三条新记录并赋值  
  32.     for(int i=0; i<3; i++)      
  33.     {  
  34.         m_pRecordset->AddNew();    //添加新记录  
  35.         m_pRecordset->PutCollect("学号",_variant_t((long)(i+10)));  
  36.         m_pRecordset->PutCollect("姓名",_variant_t("王斌年"));  
  37.         m_pRecordset->PutCollect("年龄",_variant_t((long)21));  
  38.         m_pRecordset->PutCollect("生日",_variant_t("1Array30-3-15"));  
  39.     }  
  40.     
  41.     //从第一条记录往下移动一条记录,即移动到第二条记录处  
  42.     m_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));      
  43.     m_pRecordset->PutCollect(_variant_t("年龄"),_variant_t((long)45));    //修改其年龄  
  44.     m_pRecordset->Update();    //保存到库中  
  45.     
  46. }   
  47. catch (_com_error e)  
  48. {}  

(5) 关闭记录集与连接

记录集或连接都可以用Close()方法来关闭

m_pRecordset->Close(); //关闭记录集 

m_pConnection->Close(); //关闭连接

 (6) 错误的获取

在stdafx.h中进行宏定义:

  1. #if !defined CATCH_ERROR  
  2. #define CATCH_ERROR  
  3. {  
  4.     CString strComError;  
  5.     strComError.Format("错误编号: %08lx\n错误信息: %s\n错误源: %s\n错误描述: %s",  e.Error(), e.ErrorMessage(), (LPCSTR) e.Source(), (LPCSTR) e.Description());  
  6.     ::MessageBox(NULL,strComError,"错误",MB_ICONEXCLAMATION);   
  7. }  
  8. #endif  

使用方法:
try
{  ...}
catch (_com_error e)
{
CATCH_ERROR;
}

    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多