ADO
是目前在
Windows
环境中比较流行的客户端数据库编程技术。
ADO
是建立在
OLE DB
底层技术之上的高级编程接口,因而它兼具有强大的数据处理功能(处理各种不同类型的数据源、分布式的数据处理等等)和极其简单、易用的编程接口,因而得到了广泛的应用。而且按微软公司的意图,
OLE DB
和
ADO
将逐步取代
ODBC
和
DAO
。现在介绍
ADO
各种应用的文章和书籍有很多,本文着重站在初学者的角度,简要探讨一下在
VC++
中使用
ADO
编程时的一些问题。我们希望阅读本文之前,您对
ADO
技术的基本原理有一些了解。
一、在
VC++
中使用
ADO
编程
ADO
实际上就是由一组
Automation
对象构成的组件,因此可以象使用其它任何
Automation
对象一样使用
ADO
。
ADO
中最重要的对象有三个:
Connection
、
Command
和
Recordset
,它们分别表示连接对象、命令对象和记录集对象。如果您熟悉使用
MFC
中的
ODBC
类(
CDatabase
、
CRecordset)
编程,那么学习
ADO
编程就十分容易了。
使用
ADO
编程时可以采用以下三种方法之一:
1
、使用预处理指令
#import
#import "C:/Program Files/Common Files/System/ADO/msado15.dll" /
no_namespace rename("EOF", "EndOfFile")
no_namespace rename("EOF", "EndOfFile")
但要注意不能放在
stdAfx.h
文件的开头,而应该放在所有
include
指令的后面。否则在编译时会出错。
程序在编译过程中, VC++ 会读出 msado15.dll 中的类型库信息,自动产生两个该类型库的头文件和实现文件 msado15.tlh 和 msado15.tli (在您的 Debug 或 Release 目录下)。在这两个文件里定义了 ADO 的所有对象和方法,以及一些枚举型的常量等。我们的程序只要直接调用这些方法就行了,与使用 MFC 中的 COleDispatchDriver 类调用 Automation 对象十分类似。
程序在编译过程中, VC++ 会读出 msado15.dll 中的类型库信息,自动产生两个该类型库的头文件和实现文件 msado15.tlh 和 msado15.tli (在您的 Debug 或 Release 目录下)。在这两个文件里定义了 ADO 的所有对象和方法,以及一些枚举型的常量等。我们的程序只要直接调用这些方法就行了,与使用 MFC 中的 COleDispatchDriver 类调用 Automation 对象十分类似。
2
、使用
MFC
中的
CIDispatchDriver
就是通过读取
msado15.dll
中的类型库信息,建立一个
COleDispatchDriver
类的派生类,然后通过它调用
ADO
对象。
3
、直接用
COM
提供的
API
如使用如下代码:
CLSID clsid;
HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid);
if(FAILED(hr))
{...}
::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)
&pDispatch);
if(FAILED(hr))
{...}
HRESULT hr = ::CLSIDFromProgID(L"ADODB.Connection", &clsid);
if(FAILED(hr))
{...}
::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (void **)
&pDispatch);
if(FAILED(hr))
{...}
以上三种方法,第一和第二种类似,可能第一种好用一些,第三种编程可能最麻烦。但可能第三种方法也是效率最高的,程序的尺寸也最小,并且对
ADO
的控制能力也最强。
据微软资料介绍,第一种方法不支持方法调用中的默认参数,当然第二种方法也是这样,但第三种就不是这样了。采用第三种方法的水平也最高。当你需要绕过
ADO
而直接调用
OLE DB
底层的方法时,就一定要使用第三种方法了。
ADO
编程的关键,就是熟练地运用
ADO
提供的各种对象
(object)
、方法
(method)
、属性
(property)
和容器(
collection
)。另外,如果是在
MS SQL
或
Oracle
等大型数据库上编程,还要能熟练使用
SQL
语言。
二、使用 #import 方法的编程步骤
二、使用 #import 方法的编程步骤
这里建议您使用
#import
的方法,因为它易学、易用,代码也比较简洁。
1
、
添加
#import
指令
打开
stdafx.h
文件,将下列内容添加到所有的
include
指令之后:
#include <icrsint.h> //Include support for VC++ Extensions
#import "C:/Program Files/Common Files/System/ADO/msado15.dll" /
no_namespace rename("EOF", "adoEOF")
#import "C:/Program Files/Common Files/System/ADO/msado15.dll" /
no_namespace rename("EOF", "adoEOF")
其中
icrsint.h
文件包含了
VC++
扩展的一些预处理指令、宏等的定义,用于
COM
编程时使用。
2
、定义
_ConnectionPtr
型变量,并建立数据库连接
建立了与数据库
服务器
的连接后,才能进行其他有关数据库的访问和操作。
ADO
使用
Connection
对象来建立与数据库服务器的连接,所以它相当于
MFC
中的
CDatabase
类。和
CDatabase
类一样,调用
Connection
对象的
Open
方法即可建立与服务器的连接。
数据类型
_ConnectionPtr
实际上就是由类模板
_com_ptr_t
而得到的一个具体的实例类,其定义可以到
msado15.tlh
、
comdef.h
和
comip.h
这三个文件中找到。在
msado15.tlh
中有:
_COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection));
经宏扩展后就得到了
_ConnectionPtr
类。
_ConnectionPtr
类封装了
Connection
对象的
Idispatch
接口指针,及一些必要的操作。我们就是通过这个指针来操纵
Connection
对象。类似地,后面用到的
_CommandPtr
和
_RecordsetPtr
类型也是这样得到的,它们分别表示命令对象指针和记录集对象的指针。
(
1
)、连接到
MS SQL Server
注意连接字符串的格式,提供正确的连接字符串是成功连接到数据库服务器的第一步,有关连接字符串的详细信息参见微软
MSDN Library
光盘。
本例连接字符串中的
server_name
,
database_name
,
user_name
和
password
在编程时都应该替换成实际的内容。
_ConnectionPtr pMyConnect=NULL;
HRESULT hr=pMyConnect.CreateInstance(__uuidof(Connection)));
if(FAILED(hr))return;
HRESULT hr=pMyConnect.CreateInstance(__uuidof(Connection)));
if(FAILED(hr))return;
_bstr_t strConnect="Provider=SQLOLEDB; Server=server_name;"
"Database=database_name; uid=user_name; pwd=password;";
//connecting to the database server now:
try{pMyConnect->Open(strConnect,"","",NULL);}
catch (_com_error &e)
{
::MessageBox(NULL,e.Description()," 警告 ",MB_OK │ MB_ICONWARNING);
}
"Database=database_name; uid=user_name; pwd=password;";
//connecting to the database server now:
try{pMyConnect->Open(strConnect,"","",NULL);}
catch (_com_error &e)
{
::MessageBox(NULL,e.Description()," 警告 ",MB_OK │ MB_ICONWARNING);
}
注意
Connection
对象的
Open
方法中的连接字符串参数必须是
BSTR
或
_bstr_t
类型。另外,本例是直接通过
OLE DB Provider
建立连接,所以无需建立数据源。
(
2
)、通过
ODBC Driver
连接到
Database Server
连接字符串格式与直接用
ODBC
编程时的差不多:
_bstr_t strConnect="DSN=datasource_name; Database=database_name; uid=user_name; pwd=password;";
此时与
ODBC
编程一样,必须先建立数据源。
3
、定义
_RecordsetPtr
型变量,并打开数据集
定义
_RecordsetPtr
型变量,然后通过它调用
Recordset
对象的
Open
方法,即可打开一个数据集。所以
Recordset
对象与
MFC
中的
CRecordset
类类似,它也有当前记录、当前记录指针的概念。如:
_RecordsetPtr m_pRecordset;
if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset )))
{
m_pDoc->m_initialized=FALSE;
return;
}
if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset )))
{
m_pDoc->m_initialized=FALSE;
return;
}
try{
m_pRecordset->Open(_variant_t("mytable"),
_variant_t((IDispatch *)pMyConnect,true), adOpenKeyset,
adLockOptimistic, adCmdTable);
}
catch (_com_error &e)
{
::MessageBox(NULL," 无法打开 mytable 表。 "," 提示 ",
MB_OK │ MB_ICONWARNING);
}
m_pRecordset->Open(_variant_t("mytable"),
_variant_t((IDispatch *)pMyConnect,true), adOpenKeyset,
adLockOptimistic, adCmdTable);
}
catch (_com_error &e)
{
::MessageBox(NULL," 无法打开 mytable 表。 "," 提示 ",
MB_OK │ MB_ICONWARNING);
}
Recordset
对象的
Open
方法非常重要,它的第一个参数可以是一个
SQL
语句、一个表的名字或一个命令对象等等;第二个参数就是前面建立的连接对象的指针。此外,用
Connection
和