CRecordset::SetBookmark
在包含指定的书签的记录定位记录集。
void SetBookmark(
const CDBVariant& varBookmark
);
参数
- varBookmark
对包含特定记录的 CDBVariant 对象的引用书签值。
备注
若要确定书签是否在记录集支持，请调用 CanBookmark。 若要使书签可用，只要支持，必须在 打开 成员函数的 dwOptions 参数的 CRecordset::useBookmarks 选项。
备注
如果书签是不支持或可用，调用 SetBookmark 将导致引发的异常。书签在仅向前记录集不受支持。
先中检索当前记录的书签，调用 GetBookmark，保存书签值设置为 CDBVariant 对象。 之后，使用保存的书签值，您可以返回到该记录通过调用 SetBookmark。
备注
在某些记录集操作后，应在调用 SetBookmark之前检查书签的持久性。例如，因此，如果检索与 GetBookmark 的书签然后调用 Requery，书签可能不再有效。调用 CDatabase::GetBookmarkPersistence 检查是否可以安全地调用 SetBookmark。
有关书签和记录集导航的更多信息，请参见位于 记录集:书签和绝对位置(odbc) 和 记录集:滚动(odbc)。
异常
此方法会引发类型 CDBException* 和 **CMemoryException***的异常。
要求
Header: afxdb.h