CRecordset::GetBookmark

获取当前记录的书签值。

void GetBookmark( 
   CDBVariant& varBookmark  
);

参数

  • varBookmark
    为表示当前记录的 CDBVariant 对象的引用书签。

备注

若要确定书签是否在记录集支持,请调用 CanBookmark。若要使书签可用,只要支持,必须在 打开 成员函数的 dwOptions 参数的 CRecordset::useBookmarks 选项。

说明说明

如果书签是不支持或可用,调用 GetBookmark 将导致引发的异常。书签在仅向前记录集不受支持。

GetBookmark 为当前记录进行书签的值更改为 CDBVariant 对象。在+任何+时间若要返回到该记录在移动到不同的记录之后,调用与相应的 CDBVariant 对象的 SetBookmark

说明说明

在某些记录集操作后,书签可能不再有效。例如,在中,如果调用 GetBookmark 后跟 Requery,您可能无法返回到 SetBookmark的记录。调用 CDatabase::GetBookmarkPersistence 检查是否可以安全地调用 SetBookmark

有关书签和记录集导航的更多信息,请参见位于 记录集:书签和绝对位置(odbc)记录集:滚动(odbc)

异常

此方法会引发类型 CDBException* 和 **CMemoryException***的异常。

要求

Header: afxdb.h

请参见

参考

CRecordset选件类

层次结构图

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence