ADO编程-RecordSet对象

ADO编程-RecordSet对象

标签（空格分隔）： 数据库

---

在ADO程序中，记录集（Recordset）对象代表一个表的记录集合或者是一个SQL命令或存储过程执行结果。简单地说：记录集实际上缓存了从数据库获得的记录，应用程序可以从记录集中获得每条记录的字段。

Recordset对象的常用属性和方法：

RecordCount属性：返回Recordset对象中记录的当前数目

BOF,EOF属性：BOF指示当前记录位置的第一记录的前一个，EOF指示当前记录的最后一个记录的后一个。如果打开没有记录的Recordset对象，则BOF,EOF都为true，如果打开的记录集中包含记录，则BOF,EOF都为false

AbsolutePosition属性：指定Recordset对象当前记录的序号位置

ActiveConnection属性：该属性指定Recordset当前所属的Connection对象。

Open方法定义：

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

Source参数：为记录源，它可以是下列内容之一：Command对象变量，SQL语句，存储过程，表名或完整的路径名。
ActiveConnection参数：对应于ActiveConnection属性，指定在哪个连接中打开该记录集

CursorType参数：指定打开Recordset时使用的游标
其定义如下

CursorTypeEnum
{
    adOpenUnspecified = -1, //不指定游标
    adOpenForwardOnly = 0,  //默认，前向游标。只能在Recordset的记录中向前移动，但速度最快。
    adOpenKeyset = 1, //键集游标，可以在Recordset中任意移动，其他用户所做的记录修改可见，但其他用户添加的记录不可见，删除的记录字段值不能被使用。
    adOpenDynamic = 2, //动态游标，可以在Recordset中任意移动，其他用户增、删、改的记录都可见，但速度最慢。
    adOpenStatic = 3 //静态游标，可以在Recordset中任意移动，其他用户增、删、改的记录都不可见。
};

LockType参数：指定打开记录集时应该使用的锁定类型，它的取值为

LockTypeEnum
{
    adLockUnspecified = -1,
    adLockReadOnly = 1,     //recordset的记录为只读
    adLockPessimistic = 2,  //只要保持Recordset为打开,别人就无法编辑该记录集中的记录.
    adLockOptimistic = 3,   //当update recordset中的记录时,将记录加锁(常用)
    adLockBatchOptimistic = 4   //以批模式时更新记录时加锁
};

Options参数：该参数类型为长整型值，指定source传递命令的类型

CommandTypeEnum
{
    adCmdUnspecified = -1,
    adCmdUnknown = 8,        //未知类型
    adCmdText = 1,          //SQL语句
    adCmdTable = 2,         //数据表的名字
    adCmdStoredProc = 4,    //存储过程
    adCmdFile = 256,        //文件
    adCmdTableDirect = 512
};

MoveFirst，MoveLast，MoveNext，MovePrevious方法：这些方法可以对记录集的游标进行移动操作

GetCollect方法：用于取得字段的值，参数Index可以是字符串表明字段名，也可以是整型数，表示字段的序号。

_variant_t  GetCollect(const _variant_t &Index);

PutColloct方法：用于向记录字段中写入值，pvar参数表示要写入的变量值

void PutCollect (const _variant_t &Index,const _variant_t &pvar);

AddNew()方法：使用该方法创建和初始化新记录，该方法可以使用参数，在参数中指定要添加的新纪录，也可以不使用参数，而在后面使用PutCollect方法修改新记录，使用Update函数保存新纪录

Update()方法：该方法保存从调用AddNew方法以来或更改现有记录中的任何字段值以来所做的所有更改。

使用记录集的具体方法：

定义_RecordsetPtr型变量，然后通过它调用Recordset对象的Open方法，即可打开一个数据集，然后可以使用GetCollet方法获取记录的字段值，使用Move系列函数实现记录集的遍历，最后关闭记录集。

用例

#include "stdafx.h"
#include "DataBase.h"

#import "C:\Program Files\Common Files\system\ado\msado15.dll" \
no_namespace rename("EOF", "adoEOF") rename("BOF", "adoBOF")

int main()
{
    ::CoInitialize(NULL);
    _ConnectionPtr  m_pConnection;
    _RecordsetPtr   m_pRecordSet;
    try
    {
        m_pConnection.CreateInstance(__uuidof(Connection));
        m_pRecordSet.CreateInstance(__uuidof(Recordset));
        assert(NULL != m_pConnection);
        assert(NULL != m_pRecordSet);
        if (NULL == m_pRecordSet
            || NULL == m_pConnection)
        {
            cout << "创建实例失败" << endl;
            return -1;
        }

        m_pConnection->CommandTimeout = 5;
        m_pConnection->ConnectionString = "Provider=SQLOLEDB.1;Password=123456;Persist Security Info=True;User ID=sa;Initial Catalog=sample_db;Data Source=127.0.0.1";
        m_pConnection->Open("","", "", adConnectUnspecified);
        assert(m_pConnection->GetState() == adStateOpen);
        if (m_pConnection->GetState() != adStateOpen)
        {
            cout << "连接失败" << endl;
        }

        //打开AccountsInfo表
        m_pRecordSet->Open("AccountsInfo", m_pConnection.GetInterfacePtr(), adOpenDynamic, adLockOptimistic, adCmdTable);
        assert(m_pRecordSet->GetState() == adStateOpen);
        if ( m_pRecordSet->GetState() != adStateOpen)
        {
            cout << "打开记录失败" << endl;
            return 0;
        }

        //获取数据
        long nCount = m_pRecordSet->GetRecordCount();
        cout << "nRecordCount : " << nCount << endl;
        nCount =  m_pRecordSet->Fields->GetCount();
        cout << "nRecordCount : " << nCount << endl;
        while (!m_pRecordSet->GetadoEOF())
        {
            string szName = (_bstr_t)m_pRecordSet->GetCollect("NickName");
            cout << szName << endl;
            m_pRecordSet->MoveNext();
        }

//添加记录
        m_pRecordSet->AddNew();
        m_pRecordSet->PutCollect("LogonID", "12345610");
        m_pRecordSet->PutCollect("NickName", "东东");
        m_pRecordSet->PutCollect("LogonPass", "123456");
        m_pRecordSet->PutCollect("Sex", "0");
        m_pRecordSet->Update();

    }
    catch (_com_error& e)
    {
        cout << e.Description() << endl;
    }

    ::CoUninitialize();
    return 0;
}