CRecordset::GetBookmark
取得目前資料錄的書籤值。
void GetBookmark(
CDBVariant& varBookmark
);
參數
- varBookmark
表示目前資料錄的 CDBVariant 物件的參考書籤。
備註
判斷書籤是否在資料錄集支援，呼叫 CanBookmark。若要讓書籤可用，則支援，您必須在 開啟 成員函式的 dwOptions 參數的 CRecordset::useBookmarks 選項。
.gif "注意事項") 注意事項 |
|---|
如果書籤不支援或不可見的， GetBookmark 呼叫會導致擲回例外狀況。書籤在順向資料錄集並不支援。 |
GetBookmark 指派書籤的值目前資料錄的 CDBVariant 至物件。若要隨時返回該筆移至不同的資料錄後，請呼叫對應的 CDBVariant 物件的 SetBookmark 。
| 注意事項 |
|---|
在特定資料錄集作業之後，書籤可能不再有效。例如，如果您要 GetBookmark ，後面接著 Requery，您就無法傳回至 SetBookmark的資料錄。呼叫 CDatabase::GetBookmarkPersistence 確認是否可安全地呼叫 SetBookmark。 |
如需書籤和資料錄巡覽的詳細資訊，請參閱 Microsoft 知識庫文件 資料錄集:書籤和絕對位置 (ODBC) 和 資料錄集:捲動 (ODBC)。
例外狀況
這個方法會擲回型別 CDBException* 和 **CMemoryException***的例外狀況。
需求
Header: afxdb.h