CRecordset类的常用成员函数 成员变量 以及操作实例

时间:2022-07-12 18:57:49

Open() : 打开记录集,在CRecordse类负责的一个表中,将该表看做是一个记录集,即一个数据库中的表的元组对应一个记录,表的所有元组就是一个记录的集合。

AddNew():将一个新的记录插入到表中

Update()    :  完成AddNew() 或 Edit()操作之后,调用该函数在内存中的数据保存到磁盘数据库中。

MoveNext() :将当前记录设置到下一个记录

MovePrev()   :将当前记录设置到上一个记录

MoveFrist() 将当前记录设置到记录集的第一个记录

MoveLast() 将当前记录设置到记录集的最后一个记录

IsBOF()    判断是否定位于第一个记录之前

IsEOF() 判断是否定位于最后一个记录之后

Edit() 执行对当前记录的修改

Delete() 删除当前记录

GetDefaultConnect() 获得数据源的默认连接字符串

GetDefaultSQL()    获取默认的SQL字符串

DoFieldExchange()   在记录集和数据源之间进行数据交换

GetStatus() 获取当前记录的索引

GetRecordCount() 获取用户在记录集中移动时所经过的记录数目

GetODBCFieldInfo() 获取域信息

GetODBCFieldCount() 获取记录集对象中的域的数目


Data Members

m_hstmt

Contains the ODBC statement handle for the recordset. Type HSTMT.

m_nFields

Contains the number of field data members in the recordset. Type UINT.

m_nParams

Contains the number of parameter data members in the recordset. Type UINT.

m_pDatabase

Contains a pointer to the CDatabase object through which the recordset is connected to a data source.

m_strFilter

Contains a CString that specifies a Structured Query Language (SQL) WHERE clause. Used as a filter to select only those records that meet certain criteria.

m_strSort

Contains a CString that specifies a SQL ORDER BY clause. Used to control how the records are sorted.


实例


打开MFC ClassWizard,

为控件IDC_EDIT_QUERY添加关联变量m_strQuery。


在CEx_ODBCView类中添加按钮控件IDC_BUTTON_QUERY的BN_CLICKED消息映射,在映射函数中添加代码:
void CEx_ODBCView::OnButtonQuery()
{ UpdateData();
m_strQuery.TrimLeft();
if (m_strQuery.IsEmpty())
{ MessageBox("要查询的学号不能为空!");
return;
}
if (m_pSet->IsOpen())

m_pSet->Close();

// 如果记录集打开,则先关闭


m_pSet->m_strFilter.Format("studentno='%s'",m_strQuery);

// studentno是score表的字段名,用来指定查询条件


m_pSet->m_strSort = "course";
// course是score表的字段名,用来按course字段从小到大排序
m_pSet->Open();
if (!m_pSet->IsEOF()) // 如果打开记录集有记录
UpdateData(FALSE); // 自动更新表单中控件显示的内容
else

MessageBox("没有查到你要找的学号记录!");
}
增加记录
增加记录是使用AddNew函数,但要求数据库必须是以“可增加”的方式打开的。下面的代码是在表的末尾增加新记录:
m_pSet->AddNew(); // 在表的末尾增加新记录
m_pSet->SetFieldNull(&(m_pSet->m_studentno), FALSE); // 设定m_studentno值不为空(NULL)
m_pSet-> m_studentno = "21010503";
......    // 输入新的字段值
m_pSet->Update(); // 将新记录存入数据库
m_pSet->Requery(); // 刷新记录集,这在快照集方式下是必须的

删除记录
可以直接使用CRecordSet::Delete函数来删除记录。要使删除操作有效,还需要移动记录函数。例如下面的代码:
CRecordsetStatus status;
m_pSet->GetStatus(status); // 获取当前记录集状态
m_pSet->Delete(); // 删除当前记录
if (status.m_lCurrentRecord==0) // 当前记录索引号,0表示第一条记录
m_pSet->MoveNext(); // 下移一个记录
else m_pSet->MoveFirst(); // 移动到第一个记录处
UpdateData(FALSE);


修改记录
函数CRecordSet::Edit可以用来修改记录,例如:
m_pSet->Edit();    // 修改当前记录
m_pSet->m_name="刘向东"; // 修改当前记录字段值
......
m_pSet->Update();   // 将修改结果存入数据库
m_pSet->Requery();
撤消操作
如果用户在进行增加或者修改记录后,希望放弃当前操作,则在调用CRecordSet::Update()函数之前调用CRecordSet::Move(AFX_MOVE_REFRESH)来撤消操作,便可恢复在增加或修改操作之前的当前记录。