CRecordset::SetBookmark是適用於第二次調用書籤的指向語句。
基本介紹
- 中文名：CRecordset::SetBookmark
- 類型：指向語句
- 領域：計算機編程
- 適用情況：第二次調用書籤
簡介,注意,
簡介
CRecordset::SetBookmark
void SetBookmark( const CDBVariant& varBookmark );
throw( CDBException, CMemoryException );
參數：
varBookmark | 一個指向CDBVariant對象的引用，該對象包含了一個指定記錄的書籤值。 |
說明：
此成員函式用來將記錄集定位在包含指定書籤的記錄上。為了確定在此記錄集中是否支持書籤，可以調用CanBookmark。如果支持書籤，為了使書籤可以使用，你必須設定Open成員函式中的dwOptions參數的CRecordset::useBookmarks選項。
注意
如果書籤不被支持或不能使用，調用SetBookmark將導致拋出一個異常。在只向前的記錄集中是不支持書籤的。
第一次獲取當前記錄的書籤，可調用GetBookmark，它將書籤值保存在一個CDBVariant對象中，用保存的書籤值調用SetBookmark可以返回該記錄。
在進行了一定的記錄集操作之後，你必須在調用SetBookmark之前檢查書籤是否持續可用。例如，如果你用GetBookmark獲取一個書籤，然後調用Requery，則該書籤也許已經不再有效了。調用CDabase::GetBookmarkPersistence來檢查你是否能夠安全地調用SetBookmark。
