// ---------------------------------------------------------------------------------------------------------------------------------
该接口返回一个记录集或一个空指针。
通常用它来创建一个数据库连接,或执行一条不返回任何结果的SQL语句,如一个存储过程。
不推荐使用_ConnectionPtr接口返回一个记录集,对于要返回记录集的操作通常用_RecordsetPtr来实现。
而且使用_ConnectionPtr时要想得到记录数目必须遍历所有记录,但使用_RecordsetPtr时则不需要。
// ---------------------------------------------------------------------------------------------------------------------------------
该接口返回一个记录集。
它提供了一种简单的方法来执行返回记录集的存储过程和SQL语句。
在使用_CommandPtr接口时,可以利用全局_ConnectionPtr接口,也可以在_CommandPtr 接口里直接使用连接串。
如果只执行一次或者几次数据库访问操作,后者是比较好的选择。
但是,如果频繁访问数据库,并要返回很多记录集,那么应该使用全局_ConnectionPtr接口创建一个数据库连接,然后使用_CommandPtr接口执行存储过程和SQL语句。
// ---------------------------------------------------------------------------------------------------------------------------------
该接口是一个记录集对象。
与前两种对象相比,它对记录集提供了更多的控制功能,如记录锁定、游标控制等。
同_CommandPtr接口一样,它不一定使用一个已经创建的数据库连接,可以用一个连接串代替连接指针赋给_RecordsetPtr的connection成员变量,让它自己创建数据库连接。
如果使用多个记录集,最好的方法是同Command对象一样使用已经创建了数据连接的全局_ConnectionPtr接口,然后使用_RecordsetPtr执行存储过程和SQL语句。
注意:
可以使用Recordset对象来执行查询命令,但如果查询或者存储过程是需要参数的,这时就只能使用Command对象。
使用Recordset对象操作数据库:
假定已经成功使用Connection对象创建了数据源的连接,连接指针为m_pConnection
_RecordsetPtr m_pRecordset; // 声明记录集指针
m_pRecordset.CreateInstance(__uuidof(Recordset)); // 创建记录集
或者:
_RecordsetPtr m_pRecordset; // 声明记录集指针
m_pRecordset.CreateInstance("ADODB.Recordset"); // 创建记录集
记录集指针创建完毕后,调用该指针的Open方法打开记录集。
该函数声明如下:
HRESULT Recordset15::Open(const _variant_t & Source,
const _variant_t & ActiveConnection,
enum CursorTypeEnum CursorType,
enum LockTypeEnum LockType,
long Options);
各个参数的含义如下:
参数Source:
为_variant_t类型的引用,可以为有效的Command对象、SQL语句、表名、存储过程调用等。
参数ActiveConnection:
为_variant_t类型的引用,为已经建立好的连接。
参数CursorType:
用于设置在打开Recordset时提供者应使用的游标类型,它可取CursorTypeEnum 中的任一值,默认值为adOpenForwardOnly。
参数 LockType:
用于设置在打开Recordset时提供者应使用的锁定类型,它可取枚举LockTypeEnum中的任一值,默认值为adLockReadOnly。
参数 Options:
用于设置获取Source(即Open第一个参数)的方式,其类型long。
例程1:
CString strSQL = "select * from mytablename";
m_pRecordset->Open(_variant_t (strSQL),
m_pConnection.GetInterfacePtr( ),
adOpenDynamic,
adLockOptimistic,
adCmdText);
使用SQL语句作为Open方法的第一个参数Source的值,此时Options为adCmdText
例程2:
m_pRecordset->Open(_variant_t ("tbDVDInfo"),
m_pConnection.GetInterfacePtr( ),
adOpenDynamic,
adLockOptimistic,
adCmdTable);
直接使用表名作为第一个参数,此时Options应为adCmdTable
一般在返回记录集时,通常要遍历结果记录集,以便查看或编辑某一条记录,Recoreset指针提供了几个用于实现遍历的方法。
注意:
为了避免发生异常,一般在使用MoveFirst、MovePrev之前,需要使用记录集的指针BOF属性来检测当前的记录集指针是否位于第一条记录之前;
在使用MoveLast、MoveNext之前需要使用记录集指针的EOF属性来检测当前的记录集指针是否位于最后一条记录之后。
记录集接口类提供了两种定位方法: 绝对定位和书签定位
前者通过设置或者获取AbsolutePosition属性即可,其值从1开始,并且当前记录为记录集中第一条记录时等于1
对于后者可以通过设置或获取BookMark属性即可。
读写记录集中某一记录中的一个字段,有具体有两种方法:
一:
读取操作:
_variant_t var = m_pResultSet->Fields->GetItem(_variant_t("字段名"))->Value;
也可用GetValue方法:
_variant_t var = m_pResultSet->Fields->GetItem(_variant_t("字段名"))->GetValue();
写入操作:
_variant_t var = ..... // 初始化
m_pResultSet->Fields->GetItem(_variant_t("字段名"))->Value = var;
也可用PutValue方法:
m_pResultSet->Fields->GetItem(_variant_t("字段名"))->PutValue(var);
二:
最简单的方法是直接使用如下语句:
读取操作:
_variant_t var = m_pRecordset->GetCollect (_variant_t("字段名"));
写入操作:
_variant_t var = ... // 初始化
m_pRecordset->PutCollect (_variant_t("字段名"), var);
两个方法的原型:
_variant_t GetCollect(const _variant_t & Index )
void PutCollect(const _variant_t & Index, const _variant_t &pvar)
其中:
参数Index可以是字符串表示字段名,也可以是整型,表示字段对应的序号。
pvar表示要写入的变量值。
例如:
_variant_t var;
var = m_pRentRecordset->GetCollect(_variant_t("ID"));
var = m_pRentRecordset->GetCollect(long(0)); // 都可以
更新记录集包括添加新的记录、编辑当前记录和删除当前记录
记录集接口指针对这三种操作分别提供了相应的方法
添加新的记录:AddNew
编辑当前记录:Edit
删除当前记录:Delete
注意:
记录集接口指针针对AddNew以及Edit方法提供了Update方法,用于在数据库中更新新添加或者编辑后的记录。
AddNew方法:
用于添加新纪录(该添加是直接在表的末尾续加的),该方法可以使用参数,在参数中指定要添加的新纪录;
也可以不使用参数,而在后面使用PutCollect方法,并需使用Update函数保存新纪录。
Update方法:
用于保存从调用AddNew方法以来所作的任何更改。
例程:
//在表的末尾增加新纪录
m_pRecordset->AddNew();
m_pRecordset->PutCollect(_variant_t("姓名"),
_variant_t(m_strName));
m_pRecordset->PutCollect(_variant_t("工作单位"), _variant_t(m_strComName));
m_pRecordset->PutCollect(_variant_t("单位地址"), _variant_t(m_strComAddr));
//更新数据库-将新纪录存入数据库
m_pRecordset->Update();
在对记录集的操作完成后,必须及时关闭记录集。
if ( m_pRecordset != NULL )
{
m_pRecordset ->Close( );
m_pRecordset =NULL;
}