ADO VC++ Extensions是ADO 2.0 版本提供的新接口,它支持不通过 VARIANT 便可将数据检索到本地的 C/C++ 数据类型中。此外,它还提供能简化接口使用过程的预处理宏,这些扩展程序使用简便并且性能良好。
ADO VC++ Extensions 可将 Recordset 对象的字段映射到 C/C++ 变量,字段与变量的映射称为绑定条目。预处理宏用来定义数值、定长和变长变量的绑定。
我们以一个简单的程序为例,说明如何在VC++中使用带Extensions 的ADO访问SQL SERVER数据库。我们假定安装了SQL SERVER数据库的Netbios名为nt_sqlserver,要访问的数据库名为pubs,操作的表名为authors。
我们可以新建一个空的工程,选择Win32 Console Application类型。先加入一个头文件,并命名为ADOtest.h,源代码如下:
//要使用 VC++ Extensions,必须在应用程序中包含的头文件:
#include "icrsint.h"
// 该类从"authors"表中 摘取出 fname, lname, city和state 四个字段
class CAuthorsRs : public CADORecordBinding
{
BEGIN_ADO_BINDING(CAuthorsRs)
ADO_VARIABLE_LENGTH_ENTRY2(1, adVarChar, m_au_fname,
sizeof(m_au_fname), l_fnameStatus, TRUE)
ADO_VARIABLE_LENGTH_ENTRY2(2, adVarChar, m_au_lname,
sizeof(m_au_lname), l_lnameStatus, TRUE)
ADO_VARIABLE_LENGTH_ENTRY2(3, adVarChar, m_au_city,
sizeof(m_au_city), l_cityStatus, TRUE)
ADO_VARIABLE_LENGTH_ENTRY2(4, adChar, m_au_state,
sizeof(m_au_state), l_stateStatus, TRUE)
END_ADO_BINDING()
public:
char m_au_fname[21];
ULONG l_fnameStatus;
char m_au_lname[41];
ULONG l_lnameStatus;
char m_au_city[21];
ULONG l_cityStatus;
char m_au_state[3];
ULONG l_stateStatus;
};
注意,将 BEGIN_ADO_BINDING 和 END_ADO_BINDING 宏之间的绑定条目用括号括起。不要在绑定条目结尾使用逗号或分号,因为这些定界符仅限在宏中使用。
ADO_VARIABLE_LENGTH_BINDING
_ENTRY2的参数说明如下:
参数1:按顺序的字段号码,1为标识记录集中第一字段,2为标识记录集中第二字段,依此类推。
参数2:储存已转换字段的变量的数据类型。
参数3:临时的工作缓冲区,用于将字段值从 VARIANT转换为C/C++ 变量。
参数4:变长变量所需的字节数。
参数5:指示字段转换是否成功。
参数6:布尔标志。如果为 TRUE,则表明 ADO 可以更新绑定的字段。如只检查字段而不将其更改,可设置为 FALSE。
其中第5个参数为状态参数,它可告诉你从 Recordset 字段到C或C++变量的转换是否成功以及变量的内容是否有效。该参数的两个最重要的值是adFldOK(意味着转换成功)和adFldNull(意味着字段是NULL,即无值可供转换)。程序中要检测该参数以决定C或C++变量是否有效。例如,如果字段具有有效的行内容,状态将会是adFldOK,如果移动到另一个字段为 NULL 的行,则状态将是 adFldNull。
源程序代码如下:
#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename("EOF", "EndOfFile")
#include 〈stdio.h〉
#include 〈ole2.h〉
#include "ADOtest.h"
void main()
{
if(FAILED(::CoInitialize(NULL)))
return;
// 定义ADO 智能指针类的实例,并初始化
RecordsetPtr pRstAuthors = NULL;
//定义其它变量
//接口指针声明
IADORecordBinding picRs = NULL; CAuthorsRs authorsrs;
//ADO函数要返回HRESULT,宏代码可以帮我们解释HRESULT的含义
HRESULT hr;
// 打开 位于nt_sqlserver服务器上的 pubs数据库中的 Authors 表
bstr_t strCnn("Provider=sqloledb;Data Source=nt_sqlserver;"
"Initial Catalog=pubs;User Id=sa;Password=;");
try
{
// 从 Authors 表中打开记录集
if FAILED(hr = pRstAuthors.CreateInstance(__uuidof(Recordset)))
com_issue_error(hr);
pRstAuthors-〉CursorType = adOpenStatic;
// 使用 client 游标 ,从而可以使用 AbsolutePosition 属性pRstAuthors-〉CursorLocation = adUseClient;
pRstAuthors-〉Open("SELECT au_fname, au_lname, city, "
"state FROM Authors ORDER BY au_id", strCnn, adOpenStatic,
adLockReadOnly, adCmdText);
// 打开一个 IADORecordBinding 接口指针(用来对记录集和C++类的绑定)
if FAILED(hr = pRstAuthors-〉QueryInterface(_uuidof(IADORecordBinding),(LPVOID)&&picRs))
_com_issue_error(hr);
// 调用 BindToRecordset 接口方法可使 Recordset 字段关联(或绑定)到C/C++ 变量,无论何时更改 Recordset 对象的当前行,C/C++ 变量都将自动更新
if FAILED(hr = picRs-〉BindToRecordset(&&authorsrs))
_com_issue_error(hr);
pRstAuthors-〉MoveFirst();
while(true)
{
// 显示当前记录的信息
printf("Record %ld of %d\n", pRstAuthors-〉AbsolutePosition, pRstAuthors-〉RecordCount);
printf("Author: %s %s\n ",
authorsrs.l_fnameStatus == adFldOK ?
authorsrs.m_au_fname : "〈NULL〉",
authorsrs.l_lnameStatus == adFldOK ?
authorsrs.m_au_lname : "〈NULL〉");
printf("Location: %s, %s\n",
authorsrs.l_cityStatus == adFldOK ?
authorsrs.m_au_city : "〈NULL〉",
authorsrs.l_stateStatus == adFldOK ?
authorsrs.m_au_state : "〈NULL〉");
pRstAuthors-〉MoveNext();
if(pRstAuthors-〉EndOfFile)
{
break;
}
}
// 退出前释放对象
pRstAuthors-〉Close();
// 这里释放 IADORecordset 接口
if (picRs)
picRs-〉Release();
}
catch(_com_error &&e)
{
_bstr_t bstrSource(e.Source());
_bstr_t bstrDescription(e.Description());
printf("Error\n");
printf("\tCode = %08lx\n", e.Error());
printf("\tCode meaning = %s\n", e.ErrorMessage());
printf("\tSource = %s\n", (LPCSTR) bstrSource);
printf("\tDescription = %s\n", (LPCSTR) bstrDescription);
}
::CoUninitialize();
}
编译链接之后,程序就可以运行了。这个例子的作用是将SQL SERVER中pubs库中authors表中的记录按字段au_id排序后,将记录在记录集中的位置、姓名、城市等几个字段的内容依次显示在屏幕上。
本文地址:http://com.8s8s.com/it/it176.htm