CRecordset::SetBookmark
指定したブックマークを含むレコードをレコードセットに設定します。
void SetBookmark(
const CDBVariant& varBookmark
);
パラメーター
- varBookmark
特定のレコードのブックマークの値を含む CDBVariant のオブジェクトへの参照。
解説
レコードセット内でブックマークがサポートされているかどうかを調べるには、呼び出し CanBookmark。これらがサポートされている場合、ブックマークを使用できるようにするには、[開く] のメンバー関数の dwOptions のパラメーターの CRecordset::useBookmarks オプションを設定する必要があります。
[!メモ]
ブックマークがサポートされていないか、使用できない場合に、SetBookmark を呼び出すと、例外がスローされます。ブックマークは、前方スクロール専用レコードセットではサポートされていません。
最初に現在のレコード、CDBVariant のオブジェクトにブックマークの値を保存 GetBookmark呼び出しのブックマークを取得します。後で、そのレコードに保存されたブックマークの値を使用して SetBookmark の呼び出し元に戻すことができます。
[!メモ]
特定のレコードセットの操作の後、SetBookmarkを呼び出す前にブックマークの永続性をチェックします。たとえば、GetBookmark のブックマークを取得し、[再クエリ]を呼び出すと、ブックマークが無効かがあります。SetBookmarkを安全に呼び出すことができるかどうかを確認するに CDatabase::GetBookmarkPersistence を呼び出します。
ブックマーク、レコードセットの移動に関する詳細については、" " レコードセット: ブックマークと絶対位置 (ODBC) と レコードセット: スクロール (ODBC)を参照してください。
例外
このメソッドは、型 CDBException* と **CMemoryException***の例外をスローできます。
必要条件
Header: afxdb.h