CRecordset::SetBookmark
更新 : 2007 年 11 月
指定されたブックマークを保持するレコードにレコードセットを位置付けます。
void SetBookmark(
const CDBVariant& varBookmark
);
パラメータ
- varBookmark
特定のレコードのブックマークの値を保持している CDBVariant オブジェクトへの参照。
解説
レコードセットでブックマークがサポートされているかどうかを調べるには、CanBookmark を呼び出します。ブックマークがサポートされている場合は、それを有効にするには、Open メンバ関数の dwOptions パラメータに CRecordset::useBookmarks オプションを設定します。
.gif "メモ") メモ : |
|---|
ブックマークがサポートされていないか有効でない場合は、SetBookmark を呼び出すと例外がスローされます。ブックマークは、前方参照だけのレコードセットではサポートされていません。 |
現在のレコードのブックマークを最初に取得するには、GetBookmark を呼び出し CDBVariant オブジェクトに値を保存します。後で、保存したブックマーク値を使用して SetBookmark を呼び出し、そのレコードに戻ることができます。
| メモ : |
|---|
特定のレコードセット操作後は、SetBookmark を呼び出す前にブックマークの永続性をチェックする必要があります。たとえば GetBookmark でブックマークを取得した後 Requery を呼び出した場合、ブックマークは無効になります。SetBookmark を安全に呼び出すことができるかどうかをチェックするには、CDatabase::GetBookmarkPersistence を呼び出します。 |
ブックマークとレコードセットの移動の詳細については、「Recordset: Bookmarks and Absolute Positions (ODBC)」と「レコードセット : スクロール (ODBC)」を参照してください。
例外
このメソッドは、CDBException* 型の例外と CMemoryException* 型の例外をスローできます。
必要条件
ヘッダー : afxdb.h
参照
参照
CRecordset::SetAbsolutePosition
CDatabase::GetBookmarkPersistence