次の方法で共有


CRecordset::SetBookmark

指定されたブックマークを保持するレコードにレコードセットを位置付けます。

void SetBookmark( 
   const CDBVariant& varBookmark  
);

パラメーター

  • varBookmark
    特定のレコードのブックマークの値を保持している CDBVariant オブジェクトへの参照。

解説

レコードセットでブックマークがサポートされているかどうかを調べるには、CanBookmark を呼び出します。 ブックマークがサポートされている場合は、それを有効にするには、Open メンバー関数の dwOptions パラメーターに CRecordset::useBookmarks オプションを設定します。

注意

ブックマークがサポートされていないか有効でない場合は、SetBookmark を呼び出すと例外がスローされます。 ブックマークは、前方参照だけのレコードセットではサポートされていません。

現在のレコードのブックマークを最初に取得するには、GetBookmark を呼び出し CDBVariant オブジェクトに値を保存します。 後で、保存したブックマーク値を使用して SetBookmark を呼び出し、そのレコードに戻ることができます。

注意

特定のレコードセット操作後は、SetBookmark を呼び出す前にブックマークの永続性をチェックする必要があります。 たとえば GetBookmark でブックマークを取得した後 Requery を呼び出した場合、ブックマークは無効になります。 SetBookmark を安全に呼び出すことができるかどうかをチェックするには、CDatabase::GetBookmarkPersistence を呼び出します。

ブックマークとレコード セットの移動の詳細についてを参照してくださいレコード セット:ブックマークと絶対位置 (ODBC)レコード セット:スクロール (ODBC)

例外

このメソッドは、CDBException* 型の例外と CMemoryException* 型の例外をスローできます。

必要条件

**ヘッダー:**afxdb.h

参照

参照

CRecordset クラス

階層図

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetAbsolutePosition

CDatabase::GetBookmarkPersistence

その他の技術情報

CRecordset のメンバー