/*##############################################
Filename: adorecordset.cpp
----------------------------------------------------
Remarks: ...
----------------------------------------------------
Author: 成真
Email: anyou@sina.com
anyou@msn.com
Created: 29/4/2003 8:15
###############################################*/
#include "stdafx.h"
#include "AdoRecordSet.h"
#include <math.h>
#include <io.h>
#ifdef _DEBUG
#undef THIS_FILE
static char THIS_FILE[]=__FILE__;
#define new DEBUG_NEW
#endif
/*########################################################################
------------------------------------------------
CAdoRecordSet class 构造/析构函数
------------------------------------------------
########################################################################*/
CAdoRecordSet::CAdoRecordSet()
{
m_pConnection = NULL;
m_SearchDirection = adSearchForward;
// m_pRecordset.CreateInstance("ADODB.Recordset");
m_pRecordset.CreateInstance(__uuidof( Recordset ));
#ifdef _DEBUG
if (m_pRecordset == NULL)
{
AfxMessageBox("RecordSet 对象创建失败! 请确认是否初始化了COM环境.");
}
#endif
ASSERT(m_pRecordset != NULL);
m_IsUpdate = false;
}
CAdoRecordSet::CAdoRecordSet(CAdoConnection *pConnection)
{
m_SearchDirection = adSearchForward;
m_pConnection = pConnection;
ASSERT(m_pConnection != NULL);
// m_pRecordset.CreateInstance("ADODB.Recordset");
m_pRecordset.CreateInstance(__uuidof(Recordset));
#ifdef _DEBUG
if (m_pRecordset == NULL)
{
AfxMessageBox("RecordSet 对象创建失败! 请确认是否初始化了COM环境.");
}
#endif
ASSERT(m_pRecordset != NULL);
m_IsUpdate = false;
}
CAdoRecordSet::~CAdoRecordSet()
{
Release();
}
/*========================================================================
Params:
- strSQL: SQL语句, 表名, 存储过程调用或持久 Recordset 文件名.
- CursorType: 可选. CursorTypeEnum 值, 确定打开 Recordset 时应该
使用的游标类型. 可为下列常量之一.
[常量] [说明]
-----------------------------------------------
adOpenForwardOnly 打开仅向前类型游标.
adOpenKeyset 打开键集类型游标.
adOpenDynamic 打开动态类型游标.
adOpenStatic 打开静态类型游标.
-----------------------------------------------
- LockType: 可选, 确定打开 Recordset 时应该使用的锁定类型(并发)
的 LockTypeEnum 值, 可为下列常量之一.
[常量] [说明]
-----------------------------------------------
adLockReadOnly 只读 - 不能改变数据.
adLockPessimistic 保守式锁定 - 通常通过在编辑时立即锁定数据源的记录.
adLockOptimistic 开放式锁定 - 只在调用 Update 方法时才锁定记录.
adLockBatchOptimistic 开放式批更新 - 用于批更新模式(与立即更新模式
相对).
-----------------------------------------------
- lOption 可选. 长整型值, 用于指示 strSQL 参数的类型. 可为下
列常量之一.
[常量] [说明]
-------------------------------------------------
adCmdText 指示strSQL为命令文本, 即普通的SQL语句.
adCmdTable 指示ADO生成SQL查询返回以 strSQL 命名的表中的
所有行.
adCmdTableDirect 指示所作的更改在strSQL中命名的表中返回所有行.
adCmdStoredProc 指示strSQL为存储过程.
adCmdUnknown 指示strSQL参数中的命令类型为未知.
adCmdFile 指示应从在strSQL中命名的文件中恢复保留(保存的)
Recordset.
adAsyncExecute 指示应异步执行strSQL.
adAsyncFetch 指示在提取 Initial Fetch Size 属性中指定的初始
数量后, 应该异步提取所有剩余的行. 如果所需的行尚未
提取, 主要的线程将被堵塞直到行重新可用.
adAsyncFetchNonBlocking 指示主要线程在提取期间从未堵塞. 如果所请求
的行尚未提取, 当前行自动移到文件末尾.
==========================================================================*/
BOOL CAdoRecordSet::Open(LPCTSTR strSQL, long lOption, CursorTypeEnum CursorType, LockTypeEnum LockType)
{
ASSERT(m_pConnection != NULL);
ASSERT(m_pRecordset != NULL);
ASSERT(AfxIsValidString(strSQL));
if(strcmp(strSQL, _T("")) != 0)
{
m_strSQL = strSQL;
}
if (m_pConnection == NULL || m_pRecordset == NULL)
{
return FALSE;
}
if (m_strSQL.IsEmpty())
{
ASSERT(FALSE);
return FALSE;
}
try
{
if (IsOpen()) Close();
return SUCCEEDED(m_pRecordset->Open(_variant_t(LPCTSTR(m_strSQL)),
_variant_t((IDispatch*)m_pConnection->GetConnection(), true),
CursorType, LockType, lOption));
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: 打开记录集发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
/*========================================================================
Name: 通过重新执行对象所基于的查询, 更新 Recordset 对象中的数据.
----------------------------------------------------------
Params: Options 可选. 指示影响该操作选项的位屏蔽. 如果该参数设置
为 adAsyncExecute, 则该操作将异步执行并在它结束时产生
RecordsetChangeComplete 事件
----------------------------------------------------------
Remarks: 通过重新发出原始命令并再次检索数据, 可使用 Requery 方法刷新
来自数据源的 Recordset 对象的全部内容. 调用该方法等于相继调用 Close 和
Open 方法. 如果正在编辑当前记录或者添加新记录将产生错误.
==========================================================================*/
BOOL CAdoRecordSet::Requery(long Options)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->Requery(Options) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Requery 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 从基本数据库刷新当前 Recordset 对象中的数据.
----------------------------------------------------------
Params: AffectRecords: 可选, AffectEnum 值, 决定 Resync 方法所影
响的记录数目, 可以为下列常量之一.
[常量] [说明]
------------------------------------
adAffectCurrent 只刷新当前记录.
adAffectGroup 刷新满足当前 Filter 属性设置的记录.只有将 Filter
属性设置为有效预定义常量之一才能使用该选项.
adAffectAll 默认值.刷新 Recordset 对象中的所有记录, 包括由
于当前 Filter 属性设置而隐藏的记录.
adAffectAllChapters 刷新所有子集记录.
ResyncValues: 可选, ResyncEnum 值. 指定是否覆盖基本值. 可为下列
常量之一.
[常量] [说明]
------------------------------------
adResyncAllValues 默认值. 覆盖数据, 取消挂起的更新.
adResyncUnderlyingValues 不覆盖数据, 不取消挂起的更新.
----------------------------------------------------------
Remarks: 使用 Resync 方法将当前 Recordset 中的记录与基本的数据库重新
同步. 这在使用静态或仅向前的游标但希望看到基本数据库中的改动时十分有用.
如果将 CursorLocation 属性设置为 adUseClient, 则 Resync 仅对非只读的
Recordset 对象可用.
与 Requery 方法不同, Resync 方法不重新执行 Recordset 对象的基本的命令,
基本的数据库中的新记录将不可见.
==========================================================================*/
BOOL CAdoRecordSet::Resync(AffectEnum AffectRecords, ResyncEnum ResyncValues)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->Resync(AffectRecords, ResyncValues) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Resync 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 将 Recordset 保存在持久性文件中.
----------------------------------------------------------
Params:
[strFileName]: 可选. 文件的完整路径名, 用于保存 Recordset.
[PersistFormat]: 可选. PersistFormatEnum 值, 指定保存 Recordset 所使
用的格式. 可以是如下的某个常量:
[常量] [说明]
------------------------------
adPersistADTG 使用专用的"Advanced Data Tablegram"格式保存.
adPersistXML (默认)使用 XML 格式保存.
----------------------------------------------------------
Remarks: 只能对打开的 Recordset 调用 Save 方法. 随后使用 Load 方法可
以从文件中恢复 Recordset. 如果 Filter 属性影响 Recordset, 将只保存经过
筛选的行.
在第一次保存 Recordset 时指定 FileName. 如果随后调用 Save 时, 应忽
略 FileName, 否则将产生运行时错误. 如果随后使用新的 FileName 调用 Save,
那么 Recordset 将保存到新的文件中, 但新文件和原始文件都是打开的.
==========================================================================*/
BOOL CAdoRecordSet::Save(LPCTSTR strFileName, PersistFormatEnum PersistFormat)
{
ASSERT(m_pRecordset != NULL);
ASSERT(IsOpen());
if (m_strFileName == strFileName)
{
strFileName = NULL;
}
else if(_taccess(strFileName, 0) != -1)
{
DeleteFile(strFileName);
m_strFileName = strFileName;
}
else
{
m_strFileName = strFileName;
}
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->Save(_bstr_t(strFileName), PersistFormat) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Save 发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
return FALSE;
}
return FALSE;
}
BOOL CAdoRecordSet::Load(LPCTSTR strFileName)
{
if (IsOpen()) Close();
try
{
return (m_pRecordset->Open(strFileName, "Provider=MSPersist;", adOpenForwardOnly, adLockOptimistic, adCmdFile) == S_OK);
}
catch (_com_error &e)
{
m_strErrMsg.Format("Warning: Load 发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
/*========================================================================
Name: 取消执行挂起的异步 Execute 或 Open 方法的调用.
-----------------------------------------------------
Remarks: 使用 Cancel 方法终止执行异步 Execute 或 Open 方法调用(即通
过 adAsyncConnect、adAsyncExecute 或 adAsyncFetch 参数调用的方法).
如果在试图终止的方法中没有使用 adAsyncExecute, 则 Cancel 将返回运行
时错误.
==========================================================================*/
BOOL CAdoRecordSet::Cancel()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Cancel();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Cancel发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 关闭打开的对象及任何相关对象.
-----------------------------------------------------
Remarks: 使用 Close 方法可关闭 Recordset 对象以便释放所有关联的系统
资源. 关闭对象并非将它从内存中删除, 可以更改它的属性设置并且在此后
再次打开. 要将对象从内存中完全删除, 可将对象变量设置为 NULL.
如果正在立即更新模式下进行编辑, 调用Close方法将产生错误,应首先
调用 Update 或 CancelUpdate 方法. 如果在批更新期间关闭 Recordset 对
象, 则自上次 UpdateBatch 调用以来所做的修改将全部丢失.
如果使用 Clone 方法创建已打开的 Recordset 对象的副本, 关闭原始
Recordset或其副本将不影响任何其他副本.
==========================================================================*/
void CAdoRecordSet::Close()
{
try
{
if (m_pRecordset != NULL && m_pRecordset->State != adStateClosed)
{
if (!m_IsUpdate && GetEditMode() == adEditNone) CancelUpdate();
m_pRecordset->Close();
}
}
catch (const _com_error& e)
{
m_strErrMsg.Format("Warning: 关闭记录集发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
}
/*========================================================================
Name: 关闭连接并释放对象.
-----------------------------------------------------
Remarks: 关闭连接并释放CAdoRecordSet对象, 这样基本上从内容中完全清除了
CAdoRecordSet对象.
==========================================================================*/
void CAdoRecordSet::Release()
{
if (IsOpen()) Close();
m_pRecordset.Release();
m_pRecordset = NULL;
}
/*########################################################################
------------------------------------------------
记录集更新操作
------------------------------------------------
########################################################################*/
/*========================================================================
Remarks: 开始添加新的纪录.
==========================================================================*/
BOOL CAdoRecordSet::AddNew()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
if (m_pRecordset->AddNew() == S_OK)
{
return TRUE;
}
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: AddNew 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Remarks: 在调用 AddNew 等方法后, 调用此方法完成更新或修改.
==========================================================================*/
BOOL CAdoRecordSet::Update()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
if (m_pRecordset->Update() == S_OK)
{
return TRUE;
}
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Update 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
CancelUpdate();
return FALSE;
}
/*========================================================================
Name: 将所有挂起的批更新写入磁盘.
----------------------------------------------------------
Params: AffectRecords 可选, AffectEnum 值. 决定 UpdateBatch 方法
所影响的记录数目.可以为如下常量之一.
[常量] [说明]
------------------------------------
adAffectCurrent 只写入当前记录的挂起更改.
adAffectGroup 写入满足当前 Filter 属性设置的记录所发生的挂起
更改. 必须将 Filter 属性设置为某个有效的预定义常量才能使用该选项.
adAffectAll (默认值). 写入 Recordset 对象中所有记录的挂起
更改, 包括由于当前 Filter 属性设置而隐藏的任何记录.
adAffectAllChapters 写入所有子集的挂起更改.
----------------------------------------------------------
Remarks: 按批更新模式修改 Recordset 对象时, 使用 UpdateBatch 方法可
将 Recordset 对象中的所有更改传递到基本数据库.
如果 Recordset 对象支持批更新, 那么可以将一个或多个记录的多重更改缓存在
本地, 然后再调用 UpdateBatch 方法. 如果在调用 UpdateBatch 方法时正在编
辑当前记录或者添加新的记录, 那么在将批更新传送到提供者之前, ADO 将自动
调用 Update 方法保存对当前记录的所有挂起更改.
只能对键集或静态游标使用批更新.
==========================================================================*/
BOOL CAdoRecordSet::UpdateBatch(AffectEnum AffectRecords)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->UpdateBatch(AffectRecords) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: UpdateBatch 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 取消在调用 Update 方法前对当前记录或新记录所作的任何更改.
-----------------------------------------------------
Remarks: 使用 CancelUpdate 方法可取消对当前记录所作的任何更改或放弃
新添加的记录. 在调用 Update 方法后将无法撤消对当前记录或新记录所做的更
改, 除非更改是可以用 RollbackTrans 方法回卷的事务的一部分, 或者是可以
用 CancelBatch 方法取消的批更新的一部分.
如果在调用 CancelUpdate 方法时添加新记录, 则调用 AddNew 之前的当前
记录将再次成为当前记录.
如果尚未更改当前记录或添加新记录, 调用 CancelUpdate 方法将产生错误.
==========================================================================*/
BOOL CAdoRecordSet::CancelUpdate()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
if (GetEditMode() == adEditNone || m_pRecordset->CancelUpdate() == S_OK)
{
return TRUE;
}
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: CancelUpdate 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 取消挂起的批更新.
-----------------------------------------------------
Params: AffectRecords 可选的 AffectEnum 值, 决定CancelBatch 方法
所影响记录的数目, 可为下列常量之一:
[常量] [说明]
-------------------------------------------------
AdAffectCurrent 仅取消当前记录的挂起更新.
AdAffectGroup 对满足当前 Filter 属性设置的记录取消挂起更新.
使用该选项时,必须将 Filter 属性设置为合法的预
定义常量之一.
AdAffectAll 默认值.取消 Recordset 对象中所有记录的挂起更
新,包括由当前 Filter 属性设置所隐藏的任何记录.
==========================================================================*/
BOOL CAdoRecordSet::CancelBatch(AffectEnum AffectRecords)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->CancelBatch(AffectRecords) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: CancelBatch 发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Params: AffectRecords: AffectEnum 值, 确定 Delete 方法所影响的记
录数目, 该值可以是下列常量之一.
[常量] [说明 ]
-------------------------------------------------
AdAffectCurrent 默认. 仅删除当前记录.
AdAffectGroup 删除满足当前 Filter 属性设置的记录. 要使用该选
项, 必须将 Filter 属性设置为有效的预定义常量之一.
adAffectAll 删除所有记录.
adAffectAllChapters 删除所有子集记录.
==========================================================================*/
BOOL CAdoRecordSet::Delete(AffectEnum AffectRecords)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return (m_pRecordset->Delete(AffectRecords) == S_OK);
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Delete发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*########################################################################
------------------------------------------------
记录集导航操作
------------------------------------------------
########################################################################*/
/*========================================================================
Name: 将当前记录位置移动到 Recordse 中的第一个记录.
==========================================================================*/
BOOL CAdoRecordSet::MoveFirst()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return SUCCEEDED(m_pRecordset->MoveFirst());
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: MoveFirst 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 将当前记录位置移动到 Recordset 中的最后一个记录.
-----------------------------------------------------
Remarks: Recordset 对象必须支持书签或向后光标移动; 否则调用该方法将
产生错误.
==========================================================================*/
BOOL CAdoRecordSet::MoveLast()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return SUCCEEDED(m_pRecordset->MoveLast());
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: MoveLast 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 将当前记录位置向后移动一个记录(向记录集的顶部).
-----------------------------------------------------
Remarks: Recordset 对象必须支持书签或向后游标移动; 否则方法调用将产
生错误.如果首记录是当前记录并且调用 MovePrevious 方法, 则 ADO 将当前记
录设置在 Recordset (BOF为True) 的首记录之前. 而BOF属性为 True 时向后移
动将产生错误. 如果 Recordse 对象不支持书签或向后游标移动, 则 MovePrevious
方法将产生错误.
==========================================================================*/
BOOL CAdoRecordSet::MovePrevious()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return SUCCEEDED(m_pRecordset->MovePrevious());
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: MovePrevious 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 将当前记录向前移动一个记录(向 Recordset 的底部).
-----------------------------------------------------
Remarks: 如果最后一个记录是当前记录并且调用 MoveNext 方法, 则 ADO 将
当前记录设置到 Recordset (EOF为 True)的尾记录之后. 当 EOF 属性已经为
True 时试图向前移动将产生错误.
==========================================================================*/
BOOL CAdoRecordSet::MoveNext()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return SUCCEEDED(m_pRecordset->MoveNext());
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: MoveNext 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 移动 Recordset 对象中当前记录的位置.
----------------------------------------------------------
Params:
- lRecords 带符号长整型表达式, 指定当前记录位置移动的记录数.
- Start 可选, 字符串或变体型, 用于计算书签. 也可为下列
BookmarkEnum 值之一:
[常量] [说明]
--------------------------------
adBookmarkCurrent 默认. 从当前记录开始.
adBookmarkFirst 从首记录开始.
adBookmarkLast 从尾记录开始.
==========================================================================*/
BOOL CAdoRecordSet::Move(long lRecords, _variant_t Start)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return SUCCEEDED(m_pRecordset->Move(lRecords, _variant_t(Start)));
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: Move 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*########################################################################
------------------------------------------------
记录集属性
------------------------------------------------
########################################################################*/
/*========================================================================
Name: 取得记录集对象的状态(是打开状态还是关闭状态). 对异步方式执
行的 Recordset 对象, 则说明当前的对象状态是连接、执行还是获取状态.
-----------------------------------------------------
returns: 返回下列常量之一的长整型值.
[常量] [说明]
----------------------------------
adStateClosed 指示对象是关闭的.
adStateOpen 指示对象是打开的.
adStateConnecting 指示 Recordset 对象正在连接.
adStateExecuting 指示 Recordset 对象正在执行命令.
adStateFetching 指示 Recordset 对象的行正在被读取.
-----------------------------------------------------
Remarks: 可以随时使用 State 属性确定指定对象的当前状态. 该属性是只
读的. Recordset 对象的 State 属性可以是组合值. 例如: 如果正在执行语句,
该属性将是 adStateOpen 和 adStateExecuting 的组合值.
==========================================================================*/
long CAdoRecordSet::GetState()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetState();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetState 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
return -1;
}
BOOL CAdoRecordSet::IsOpen()
{
try
{
return (m_pRecordset != NULL && (GetState() & adStateOpen));
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: IsOpen方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 指示有关批更新或其他大量操作的当前记录的状态.
-----------------------------------------------------
returns: 返回下列一个或多个 RecordStatusEnum 值之和.
[常量] [说明]
-------------------------------------------------
adRecOK 成功地更新记录.
adRecNew 记录是新建的.
adRecModified 记录被修改.
adRecDeleted 记录被删除.
adRecUnmodified 记录没有修改.
adRecInvalid 由于书签无效, 记录没有保存.
adRecMultipleChanges 由于影响多个记录, 因此记录未被保存.
adRecPendingChanges 由于记录引用挂起的插入, 因此未被保存.
adRecCanceled 由于操作被取消, 未保存记录.
adRecCantRelease 由于现有记录锁定, 没有保存新记录.
adRecConcurrencyViolation 由于开放式并发在使用中, 记录未被保存.
adRecIntegrityViolation 由于用户违反完整性约束, 记录未被保存.
adRecMaxChangesExceeded 由于存在过多挂起更改, 记录未被保存.
adRecObjectOpen 由于与打开的储存对象冲突, 记录未被保存.
adRecOutOfMemory 由于计算机内存不足, 记录未被保存.
adRecPermissionDenied 由于用户没有足够的权限, 记录未被保存.
adRecSchemaViolation 由于记录违反基本数据库的结构, 因此未被保存.
adRecDBDeleted 记录已经从数据源中删除.
-----------------------------------------------------
Remarks: 使用 Status 属性查看在批更新中被修改的记录有哪些更改被挂起.
也可使用 Status 属性查看大量操作时失败记录的状态. 例如, 调用 Recordset
对象的 Resync、UpdateBatch 或 CancelBatch 方法, 或者设置 Recordset 对象
的 Filter 属性为书签数组. 使用该属性, 可检查指定记录为何失败并将问题解
决.
==========================================================================*/
long CAdoRecordSet::GetStatus()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetStatus();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetStatus 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
return -1;
}
/*========================================================================
Name: 获取当前记录集中记录数目
==========================================================================*/
long CAdoRecordSet::GetRecordCount()
{
ASSERT(m_pRecordset != NULL);
try
{
long count = m_pRecordset->GetRecordCount();
// 如果ado不支持此属性,则手工计算记录数目 --------
if (count < 0)
{
long pos = GetAbsolutePosition();
MoveFirst();
count = 0;
while (!IsEOF())
{
count++;
MoveNext();
}
SetAbsolutePosition(pos);
}
return count;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetRecordCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
Name: 获取当前记录集中字段数目
==========================================================================*/
long CAdoRecordSet::GetFieldsCount()
{
ASSERT(m_pRecordset != NULL);
try
{
return GetFields()->Count;
}
catch(_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldsCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
Name: 指示通过查询返回 Recordset 的记录的最大数目.
==========================================================================*/
long CAdoRecordSet::GetMaxRecordCount()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetMaxRecords();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetMaxRecordCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
BOOL CAdoRecordSet::SetMaxRecordCount(long count)
{
ASSERT(m_pRecordset != NULL);
try
{
m_pRecordset->PutMaxRecords(count);
return TRUE;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetMaxRecordCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
/*========================================================================
Name: 指针是否在在记录集头
==========================================================================*/
BOOL CAdoRecordSet::IsBOF()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->adoBOF;
}
catch(_com_error e)
{
m_strErrMsg.Format("Warning: IsBOF 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
/*========================================================================
Name: 指针是否在在记录集尾
==========================================================================*/
BOOL CAdoRecordSet::IsEOF()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->adoEOF;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: IsEOF 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
EditModeEnum CAdoRecordSet::GetEditMode()
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
return m_pRecordset->GetEditMode();
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetEditMode 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return adEditNone;
}
return adEditNone;
}
long CAdoRecordSet::GetPageCount()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetPageCount();
}
catch (_com_error &e)
{
m_strErrMsg.Format("Warning: GetPageCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
BOOL CAdoRecordSet::SetCacheSize(const long &lCacheSize)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL && !(GetState() & adStateExecuting))
{
m_pRecordset->PutCacheSize(lCacheSize);
}
}
catch (const _com_error& e)
{
m_strErrMsg.Format("Warning: SetCacheSize方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return TRUE;
}
long CAdoRecordSet::GetPageSize()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetPageSize();
}
catch (_com_error &e)
{
m_strErrMsg.Format("Warning: GetPageCount 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
name: 指定当前记录所在的页.
----------------------------------------------------------
returns: 置或返回从 1 到 Recordset 对象 (PageCount) 所含页数的长整型
值,或者返回以下常量.
[常量] [说明]
---------------------------------
adPosUnknown Recordset 为空,当前位置未知,或者提供者不支持 AbsolutePage 属性.
adPosBOF 当前记录指针位于 BOF(即 BOF 属性为 True).
adPosEOF 当前记录指针位于 EOF(即 EOF 属性为 True).
==========================================================================*/
BOOL CAdoRecordSet::SetAbsolutePage(int nPage)
{
ASSERT(m_pRecordset != NULL);
try
{
m_pRecordset->PutAbsolutePage((enum PositionEnum)nPage);
return TRUE;
}
catch(_com_error &e)
{
m_strErrMsg.Format("Warning: SetAbsolutePage 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
long CAdoRecordSet::GetAbsolutePage()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetAbsolutePage();
}
catch(_com_error &e)
{
m_strErrMsg.Format("Warning: GetAbsolutePage 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
name: 指定 Recordset 对象当前记录的序号位置.
----------------------------------------------------------
returns: 设置或返回从 1 到 Recordset 对象 (PageCount) 所含页数的长整
型值,或者返回以下常量.
[常量] [说明]
---------------------------------
adPosUnknown Recordset 为空,当前位置未知,或者提供者不支持 AbsolutePage 属性.
adPosBOF 当前记录指针位于 BOF(即 BOF 属性为 True).
adPosEOF 当前记录指针位于 EOF(即 EOF 属性为 True).
----------------------------------------------------------
Remarks: 使用 AbsolutePosition 属性可根据其在 Recordset 中的序号
位置移动到记录,或确定当前记录的序号位置. 提供者必须支持该属性的相应功
能才能使用该属性.
同 AbsolutePage 属性一样,AbsolutePosition 从 1 开始,并在当前记录
为 Recordset 中的第一个记录时等于 1. 从 RecordCount 属性可获得 Recordset
对象的总记录数.
设置 AbsolutePosition 属性时,即使该属性指向位于当前缓存中的记录,
ADO 也将使用以指定的记录开始的新记录组重新加载缓存. CacheSize 属性决定
该记录组的大小.
注意 不能将 AbsolutePosition 属性作为替代的记录编号使用. 删除前面
的记录时,给定记录的当前位置将发生改变. 如果 Recordset 对象被重新查询或
重新打开,则无法保证给定记录有相同的 AbsolutePosition. 书签仍然是保持和
返回给定位置的推荐方式,并且在所有类型的 Recordset 对象的定位时是唯一的
方式.
==========================================================================*/
BOOL CAdoRecordSet::SetAbsolutePosition(int nPosition)
{
ASSERT(m_pRecordset != NULL);
try
{
m_pRecordset->PutAbsolutePosition((enum PositionEnum)nPosition);
return TRUE;
}
catch(_com_error &e)
{
m_strErrMsg.Format("Warning: SetAbsolutePosition 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
long CAdoRecordSet::GetAbsolutePosition()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetAbsolutePosition();
}
catch(_com_error &e)
{
m_strErrMsg.Format("Warning: GetAbsolutePosition 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
BOOL CAdoRecordSet::SetCursorLocation(CursorLocationEnum CursorLocation)
{
ASSERT(m_pRecordset != NULL);
try
{
m_pRecordset->PutCursorLocation(CursorLocation);
return TRUE;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: PutCursorLocation 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
CursorLocationEnum CAdoRecordSet::GetCursorLocation()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetCursorLocation();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetCursorLocation 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return adUseNone;
}
}
BOOL CAdoRecordSet::SetCursorType(CursorTypeEnum CursorType)
{
ASSERT(m_pRecordset != NULL);
try
{
m_pRecordset->PutCursorType(CursorType);
return TRUE;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: SetCursorType 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
CursorTypeEnum CAdoRecordSet::GetCursorType()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetCursorType();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetCursorType 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return adOpenUnspecified;
}
}
/*========================================================================
Remarks: Recordset 对象包括 Field 对象组成的 Fields 集合. 每个Field
对象对应 Recordset 集中的一列.
==========================================================================*/
FieldsPtr CAdoRecordSet::GetFields()
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->GetFields();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFields 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return NULL;
}
return NULL;
}
/*========================================================================
Remarks: 取得指定列字段的字段名.
==========================================================================*/
CString CAdoRecordSet::GetFieldName(long lIndex)
{
ASSERT(m_pRecordset != NULL);
CString strFieldName;
try
{
strFieldName = LPCTSTR(m_pRecordset->Fields->GetItem(_variant_t(lIndex))->GetName());
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldName 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
return strFieldName;
}
/*========================================================================
name: 取得 Field 对象一项或多项属性.
----------------------------------------------------------
returns: 对于 Field 对象, Attributes 属性为只读, 其值可能为以下任意
一个或多个 FieldAttributeEnum 值的和.
[常量] [说明]
-------------------------------------------
adFldMayDefer 指示字段被延迟, 即不从拥有整个记录的数据源检索
字段值, 仅在显式访问这些字段时才进行检索.
adFldUpdatable 指示可以写入该字段.
adFldUnknownUpdatable 指示提供者无法确定是否可以写入该字段.
adFldFixed 指示该字段包含定长数据.
adFldIsNullable 指示该字段接受 Null 值.
adFldMayBeNull 指示可以从该字段读取 Null 值.
adFldLong 指示该字段为长二进制字段. 并指示可以使用 AppendChunk
和 GetChunk 方法.
adFldRowID 指示字段包含持久的行标识符, 该标识符无法被写入
并且除了对行进行标识(如记录号、唯一标识符等)外不
存在有意义的值.
adFldRowVersion 指示该字段包含用来跟踪更新的某种时间或日期标记.
adFldCacheDeferred 指示提供者缓存了字段值, 并已完成随后对缓存的读取.
==========================================================================*/
long CAdoRecordSet::GetFieldAttributes(long lIndex)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lIndex))->GetAttributes();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldAttributes 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
long CAdoRecordSet::GetFieldAttributes(LPCTSTR lpszFieldName)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lpszFieldName))->GetAttributes();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldAttributes 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
Name: 指示 Field 对象所定义的长度.
----------------------------------------------------------
returns: 返回某个字段定义的长度(按字节数)的长整型值.
----------------------------------------------------------
Remarks: 使用 DefinedSize 属性可确定 Field 对象的数据容量.
==========================================================================*/
long CAdoRecordSet::GetFieldDefineSize(long lIndex)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lIndex))->DefinedSize;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetDefineSize 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
long CAdoRecordSet::GetFieldDefineSize(LPCTSTR lpszFieldName)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lpszFieldName))->DefinedSize;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetDefineSize 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
Name: 取得字段的值的实际长度.
----------------------------------------------------------
returns: 返回长整型值.某些提供者允许设置该属性以便为 BLOB 数据预留
空间, 在此情况下默认值为 0.
----------------------------------------------------------
Remarks: 使用 ActualSize 属性可返回 Field 对象值的实际长度.对于所有
字段,ActualSize 属性为只读.如果 ADO 无法确定 Field 对象值的实
际长度, ActualSize 属性将返回 adUnknown.
如以下范例所示, ActualSize 和 DefinedSize 属性有所不同:
adVarChar 声明类型且最大长度为 50 个字符的 Field 对象将返回为
50 的 DefinedSize 属性值, 但是返回的 ActualSize 属性值是当前记
录的字段中存储的数据的长度.
==========================================================================*/
long CAdoRecordSet::GetFieldActualSize(long lIndex)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lIndex))->ActualSize;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldActualSize 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
long CAdoRecordSet::GetFieldActualSize(LPCTSTR lpszFieldName)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lpszFieldName))->ActualSize;
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetFieldActualSize 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return -1;
}
}
/*========================================================================
returns: 返回下列值之一. 相应的 OLE DB 类型标识符在下表的说明栏的括
号中给出.
[常量] [说明]
---------------------------------------------------------
adArray 与其他类型一起加入逻辑 OR 以指示该数据是那种类型的
安全数组 (DBTYPE_ARRAY).
adBigInt 8 字节带符号的整数 (DBTYPE_I8).
adBinary 二进制值 (DBTYPE_BYTES).
adBoolean 布尔型值 (DBTYPE_BOOL).
adByRef 与其他类型一起加入逻辑 OR 以指示该数据是其他类型数
据的指针 (DBTYPE_BYREF).
adBSTR 以空结尾的字符串 (Unicode) (DBTYPE_BSTR).
adChar 字符串值 (DBTYPE_STR).
adCurrency 货币值 (DBTYPE_CY).货币数字的小数点位置固定、小数
点右侧有四位数字.该值保存为 8 字节范围为10,000 的带符
号整型值.
adDate 日期值 (DBTYPE_DATE).日期按双精度型数值来保存, 数
字全部表示从 1899 年 12 月 30 开始的日期数.小数部分是
一天当中的片段时间.
adDBDate 日期值 (yyyymmdd) (DBTYPE_DBDATE).
adDBTime 时间值 (hhmmss) (DBTYPE_DBTIME).
adDBTimeStamp 时间戳 (yyyymmddhhmmss 加 10 亿分之一的小数)(DBTYPE_DBTIMESTAMP).
adDecimal 具有固定精度和范围的精确数字值 (DBTYPE_DECIMAL).
adDouble 双精度浮点值 (DBTYPE_R8).
adEmpty 未指定值 (DBTYPE_EMPTY).
adError 32 - 位错误代码 (DBTYPE_ERROR).
adGUID 全局唯一的标识符 (GUID) (DBTYPE_GUID).
adIDispatch OLE 对象上 Idispatch 接口的指针 (DBTYPE_IDISPATCH).
adInteger 4 字节的带符号整型 (DBTYPE_I4).
adIUnknown OLE 对象上 IUnknown 接口的指针 (DBTYPE_IUNKNOWN).
adLongVarBinary 长二进制值.
adLongVarChar 长字符串值.
adLongVarWChar 以空结尾的长字符串值.
adNumeric 具有固定精度和范围的精确数字值 (DBTYPE_NUMERIC).
adSingle 单精度浮点值 (DBTYPE_R4).
adSmallInt 2 字节带符号整型 (DBTYPE_I2).
adTinyInt 1 字节带符号整型 (DBTYPE_I1).
adUnsignedBigInt 8 字节不带符号整型 (DBTYPE_UI8).
adUnsignedInt 4 字节不带符号整型 (DBTYPE_UI4).
adUnsignedSmallInt 2 字节不带符号整型 (DBTYPE_UI2).
adUnsignedTinyInt 1 字节不带符号整型 (DBTYPE_UI1).
adUserDefined 用户定义的变量 (DBTYPE_UDT).
adVarBinary 二进制值.
adVarChar 字符串值.
adVariant 自动变体型 (DBTYPE_VARIANT).
adVector 与其他类型一起加入逻辑 OR 中, 指示数据是 DBVECTOR
结构(由 OLE DB 定义).该结构含有元素的计数和其他类型
(DBTYPE_VECTOR) 数据的指针.
adVarWChar 以空结尾的 Unicode 字符串.
adWChar 以空结尾的 Unicode 字符串 (DBTYPE_WSTR).
----------------------------------------------------------
Remarks: 返回指定字段的数据类型.
==========================================================================*/
DataTypeEnum CAdoRecordSet::GetFieldType(long lIndex)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lIndex))->GetType();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetField 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return adEmpty;
}
}
DataTypeEnum CAdoRecordSet::GetFieldType(LPCTSTR lpszFieldName)
{
ASSERT(m_pRecordset != NULL);
try
{
return m_pRecordset->Fields->GetItem(_variant_t(lpszFieldName))->GetType();
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetField发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return adEmpty;
}
}
BOOL CAdoRecordSet::IsFieldNull(LPCTSTR lpFieldName)
{
try
{
_variant_t vt = m_pRecordset->Fields->GetItem(lpFieldName)->Value;
return (vt.vt == VT_NULL);
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: IsFieldNull 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
BOOL CAdoRecordSet::IsFieldNull(long index)
{
try
{
_variant_t vt = m_pRecordset->Fields->GetItem(_variant_t(index))->Value;
return (vt.vt == VT_NULL);
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: IsFieldNull 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
}
/*========================================================================
Name: 取得指定列的字段对象的指针.
==========================================================================*/
FieldPtr CAdoRecordSet::GetField(long lIndex)
{
try
{
return GetFields()->GetItem(_variant_t(lIndex));
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetField发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return NULL;
}
}
FieldPtr CAdoRecordSet::GetField(LPCTSTR lpszFieldName)
{
try
{
return GetFields()->GetItem(_variant_t(lpszFieldName));
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: GetField发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return NULL;
}
}
/*########################################################################
------------------------------------------------
设置字段的值
------------------------------------------------
########################################################################*/
BOOL CAdoRecordSet::PutCollect(long index, const _variant_t &value)
{
ASSERT(m_pRecordset != NULL);
ASSERT(index < GetFieldsCount());
try
{
if (m_pRecordset != NULL)
{
m_pRecordset->PutCollect(_variant_t(index), value);
return TRUE;
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: PutCollect 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
BOOL CAdoRecordSet::PutCollect(LPCSTR strFieldName, const _variant_t &value)
{
ASSERT(m_pRecordset != NULL);
try
{
if (m_pRecordset != NULL)
{
m_pRecordset->put_Collect(_variant_t(strFieldName), value);
return TRUE;
}
}
catch (_com_error e)
{
m_strErrMsg.Format("Warning: PutCollect 方法发生异常. 错误信息: %s; 文件: %s; 行: %d\n",(LPCTSTR)e.Description(), __FILE__, __LINE__);
TRACE(m_strErrMsg);
return FALSE;
}
return FALSE;
}
BOOL CAdoRecordSet::PutCollect(long index, const bool &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adBoolean)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const bool &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adBoolean)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const BYTE &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adUnsignedTinyInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const BYTE &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adUnsignedTinyInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const short &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adSmallInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const short &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adSmallInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const int &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adInteger)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(long(value)));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const int &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adInteger)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(long(value)));
}
BOOL CAdoRecordSet::PutCollect(long index, const long &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adBigInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const long &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adBigInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const DWORD &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adUnsignedBigInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = VT_UI4;
vt.ulVal = value;
return PutCollect(index, vt);
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const DWORD &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adUnsignedBigInt)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = VT_UI4;
vt.ulVal = value;
return PutCollect(strFieldName, vt);
}
BOOL CAdoRecordSet::PutCollect(long index, const float &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adSingle)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const float &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adSingle)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const double &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adDouble)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(index, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const double &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adDouble)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
return PutCollect(strFieldName, _variant_t(value));
}
BOOL CAdoRecordSet::PutCollect(long index, const COleDateTime &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if ( GetFieldType(index) != adDate
&& GetFieldType(index) != adDBDate
&& GetFieldType(index) != adDBTime
&& GetFieldType(index) != adDBTimeStamp)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = VT_DATE;
vt.date = value;
return PutCollect(index, vt);
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const COleDateTime &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if ( GetFieldType(strFieldName) != adDate
&& GetFieldType(strFieldName) != adDBDate
&& GetFieldType(strFieldName) != adDBTime
&& GetFieldType(strFieldName) != adDBTimeStamp)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = VT_DATE;
vt.date = value;
return PutCollect(strFieldName, vt);
}
BOOL CAdoRecordSet::PutCollect(long index, const COleCurrency &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(index) != adCurrency)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
if (value.m_status == COleCurrency::invalid) return FALSE;
_variant_t vt;
vt.vt = VT_CY;
vt.cyVal = value.m_cur;
return PutCollect(index, vt);
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const COleCurrency &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (GetFieldType(strFieldName) != adCurrency)
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
if (value.m_status == COleCurrency::invalid) return FALSE;
_variant_t vt;
vt.vt = VT_CY;
vt.cyVal = value.m_cur;
return PutCollect(strFieldName, vt);
}
BOOL CAdoRecordSet::PutCollect(long index, const CString &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (! (GetFieldType(index) == adVarChar
|| GetFieldType(index) == adChar
|| GetFieldType(index) == adLongVarChar
|| GetFieldType(index) == adVarWChar
|| GetFieldType(index) == adWChar
|| GetFieldType(index) == adLongVarWChar))
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = value.IsEmpty() ? VT_NULL : VT_BSTR;
vt.bstrVal = value.AllocSysString();
return PutCollect(index, vt);
}
BOOL CAdoRecordSet::PutCollect(LPCTSTR strFieldName, const CString &value)
{
ASSERT(m_pRecordset != NULL);
#ifdef _DEBUG
if (! (GetFieldType(strFieldName) == adVarChar
|| GetFieldType(strFieldName) == adChar
|| GetFieldType(strFieldName) == adLongVarChar
|| GetFieldType(strFieldName) == adVarWChar
|| GetFieldType(strFieldName) == adWChar
|| GetFieldType(strFieldName) == adLongVarWChar))
{
m_strErrMsg.Format("Warning: 你要存贮的字段与变量的数据类型不符; 文件: %s; 行: %d\n", __FILE__, __LINE__);
TRACE(m_strErrMsg);
}
#endif
_variant_t vt;
vt.vt = value.IsEmpty() ? VT_NULL : VT_BSTR;
vt.bstrVal = value.AllocSysString();
return PutCollect(strFieldName, vt);
}
/*########################################################################
------------------------------------------------
读取字段的值
------------------------------------------------
########################################################################*/
BOOL CAdoRecordSet::GetCollect(long in