次の方法で共有


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

参照

関連項目

CRecordset クラス

階層図

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetAbsolutePosition

CDatabase::GetBookmarkPersistence