ADO VC++ Extensions使用详解

类别:VC语言 点击:0 评论:0 推荐:

  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