CRecordset::SetBookmark

[アーティクル]
08/09/2011

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

void SetBookmark( 
   const CDBVariant& varBookmark  
);

パラメーター

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

解説

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

注意

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

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

注意

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

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