ADO(ActiveX Data Object)是 Microsoft 数据库应用程序开发的新接口,是建立在 OLE DB
之上的高层数据库访问技术,即使你对 OLE DB,COM 不了解也能轻松对付 ADO,因为它非
常简单易用,甚至比你以往所接触的 ODBC API、DAO、RDO 都要容易使用,并不失灵活
性。本文详细地介绍在 Visual C++开发环境下如何使用 ADO 来进行数据库应用程序开发,
并给出示例代码。为了使读者朋友都能测试本例提供的代码,我们采用 Access 数据库,您
可以直接在我们提供的示例代码中找到这个 test.mdb。程序编译运行后的效果如图一所示:
图一、ADO 操作 ACESS 数据库的界面效果图
一、实现方法
万事开头难,任何一种新技术对于初学者来说最重要的还是"入门",掌握其要点。让我
们来看看 ADO 数据库开发的基本流程吧!它的基本步骤如下:
(1)初始化 COM 库,引入 ADO 库定义文件
(2)用 Connection 对象连接数据库
(3)利用建立好的连接,通过 Connection、Command 对象执行 SQL 命令,或利用
Recordset 对象取得结果记录集进行查询、处理。
(4)使用完毕后关闭连接释放对象。
下面我们将详细介绍上述步骤并给出相关代码。
1、COM 库的初始化
我们可以使用 AfxOleInit()来初始化 COM 库,这项工作通常在 CWinApp::InitInstance()
的重载函数中完成,请看如下代码:
BOOL CADOTest1App::InitInstance()
{
AfxOleInit();
......
}
2、用#import 指令引入 ADO 类型库
为了引入 ADO 类型库,需要在项目的 stdafx.h 文件中加入如下语句:
#import "c:\program files\common files\system\ado\msado15.dll"
no_namespace rename("EOF","adoEOF")
这一语句有何作用呢?其最终作用同我们已经十分熟悉的#include 类似,编译的时候系
统会为我们生成 msado15.tlh,ado15.tli 两个 C++头文件来定义 ADO 库。
需要读者朋友注意的是:您的开发环境中 msado15.dll 不一定在这个目录下,请按实际
情况修改;在编译的时候可能会出现如下警告,对此微软在 MSDN 中作了说明,并建议我
们 不 要 理 会 这 个 警 告 : msado15.tlh(405) : warning C4146: unary minus operator applied to
unsigned type, result still unsigned。
3、创建 Connection 对象并连接数据库
为了首先我们需要添加一个指向 Connection 对象的指针_ConnectionPtr m_pConnection,
下面的代码演示了如何创建 Connection 对象实例及如何连接数据库并进行异常捕捉:
BOOL CADOTest1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
HRESULT hr;
try
{
hr = m_pConnection.CreateInstance("ADODB.Connection");///创建 Connection 对象
if(SUCCEEDED(hr))
{
hr = m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;
Data Source=test.mdb","","",adModeUnknown);///连接数据库
//上面一句中连接字串中的 Provider 是针对 ACCESS2000 环境的,对于 ACCESS97,
//需要改为:Provider=Microsoft.Jet.OLEDB.3.51;
}
}
catch(_com_error e)///捕捉异常
{
CString errormessage;
errormessage.Format("连接数据库失败!\r\n 错误信息:%s",e.ErrorMessage());
AfxMessageBox(errormessage);///显示错误信息
}
在这段代码中我们是通过 Connection 对象的 Open 方法来进行连接数据库的,下面是该
方法的原型:
HRESULT Connection15::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:阻止其它 Connection 对象以任何权限打开连接
我们给出一些常用的连接方式供大家参考:
(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);
(3)不通过 DSN 对 SQL SERVER 数据库进行连接:
m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;
UID=sa;PWD=139","","",adModeUnknown);
其中 Server 是 SQL 服务器的名称,DATABASE 是库的名称。
Connection 对象除 Open()方法外还有许多方法,我们先介绍 Connection 对象中两个
有用的属性 ConnectionTimeOut 与 State。ConnectionTimeOut 用来设置连接的超时时间,需
要在 Open 之前调用,例如:
m_pConnection->ConnectionTimeout = 5;///设置超时时间为 5 秒
m_pConnection->Open("Data Source=adotest;","","",adModeUnknown);
State 属性指明当前 Connection 对象的状态,0 表示关闭,1 表示已经打开,我们可以通
过读取这个属性来作相应的处理,例如:
if(m_pConnection->State)
m_pConnection->Close(); ///如果已经打开了连接则关闭它
4、执行 SQL 命令并取得结果记录集
为 了 取 得 结 果 记 录 集 , 我 们 定 义 一 个 指 向 Recordset 对 象 的 指 针 :_RecordsetPtr
m_pRecordset;
并为其创建 Recordset 对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset"),
SQL 命令的执行可以采用多种形式,下面我们一一进行阐述。
(1)利用 Connection 对象的 Execute 方法执行 SQL 命令
Execute()方法的原型如下所示:
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options )
其中 CommandText 是命令字串,通常是 SQL 命令。参数 RecordsAffected 是操作完成
后所影响的行数, 参数 Options 表示 CommandText 中内容的类型,Options 可以取如下值之
一:adCmdText 表明 CommandText 是文本命令;adCmdTable 表明 CommandText 是一个表
名;adCmdProc 表明 CommandText 是一个存储过程;adCmdUnknown 表明 CommandText
内容未知。Execute()函数执行完后返回一个指向记录集的指针,下面我们给出具体代码
并作说明:
_variant_t RecordsAffected;
///执行 SQL 命令:CREATE TABLE 创建表格 users,users 包含四个字段:整形 ID,字符串 username,整形 old,日
期型 birthday
m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username
TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText);
///往表格里面添加记录
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday)
VALUES (1, 'Washington',25,'1970/1/1')",&RecordsAffected,adCmdText);
///将所有记录 old 字段的值加一
m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
///执行 SQL 统计命令得到包含记录条数的记录集
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM
users",&RecordsAffected,adCmdText);
_variant_t vIndex = (long)0;
_variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入 vCount 变量
m_pRecordset->Close();///关闭记录集
CString message;
message.Format("共有%d 条记录",vCount.lVal);
AfxMessageBox(message);///显示当前记录条数
(2)利用 Command 对象来执行 SQL 命令
_CommandPtr m_pCommand;
m_pCommand.CreateInstance("ADODB.Command");
_variant_t vNULL;
vNULL.vt = VT_ERROR;
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数
m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它
m_pCommand->CommandText = "SELECT * FROM users";///命令字串
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);
//执行命令取得记录集
在这段代码中我们只是用 Command 对象来执行了 SELECT 查询语句,Command 对象
在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
(3)直接用 Recordset 对象进行查询取得记录集,例如:
m_pRecordset->Open("SELECT * FROM users",_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 )
上述函数中参数 Source 是数据查询字符串;参数 ActiveConnection 是已经建立好的连
接(我们需要用 Connection 对象指针来构造一个_variant_t 对象);参数 CursorType 光标类
型,它可以是以下值之一;请看这个枚举结构:
enum CursorTypeEnum
{
adOpenUnspecified = -1,///不作特别指定
adOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用 MoveNext 向前滚动,这
种方式可以提高浏览速度。但诸如 BookMark,RecordCount,AbsolutePosition,AbsolutePage 都不能使用
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的
操作对你是可见的。
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
adOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作
对你的记录集来说是不可见的。
};
参数 LockType 表示数据库的锁定类型,它可以是以下值之一,请看如下枚举结构:
enum LockTypeEnum
{
adLockUnspecified = -1,///未指定
adLockReadOnly = 1,///只读记录集
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
adLockOptimistic = 3,乐观锁定方式。只有在你调用 Update 方法时才锁定记录。在此之前仍然可以做数
据的更新、插入、删除等动作
adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下
完成。
};