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