다음을 통해 공유

CRecordset::SetBookmark

  • 아티클

 

게시: 2016년 4월

지정한 책갈피가 포함 된 레코드에 레코드 집합을 배치 합니다.

구문

      void SetBookmark( 
   const CDBVariant& varBookmark  
);

매개 변수

  • varBookmark
    참조 하는 CDBVariant 특정 레코드에 대 한 책갈피 값을 포함 하는 개체입니다.

설명

레코드 집합에서 책갈피가 지원 되는지 확인 하려면 호출 CanBookmark. 책갈피는 지원 되는 경우에 사용할 수 있도록 설정 해야 합니다의 CRecordset::useBookmarks 옵션에 dwOptions 매개 변수는 열려 멤버 함수.

참고

책갈피 지원 되지 않거나 사용할 수 없는 경우 호출 SetBookmark 예외가 throw 됩니다.앞 으로만 이동 가능한 레코드 집합에 책갈피를 지원 하지 않습니다.

먼저 현재 레코드의 책갈피를 검색 하려면 호출 GetBookmark, 책갈피 값으로는 저장 된 CDBVariant 개체. 나중에 호출 하 여 해당 레코드로 돌아갈 수 있습니다 SetBookmark 저장 된 책갈피 값을 사용 합니다.

참고

특정 레코드 집합 작업 후 책갈피 지 속성을 호출 하기 전에 확인 해야 SetBookmark.예를 들어, 책갈피를 검색 하는 경우 GetBookmark 다음 Requery, 책갈피는 더 이상 유효 하지 않을 수 없습니다.호출 CDatabase::GetBookmarkPersistence 안전 하 게 호출할 수 있는지 여부를 확인 하려면 SetBookmark.

책갈피 및 레코드 집합 탐색에 대 한 자세한 내용은 문서를 참조 하십시오. 레코드 집합: 책갈피와 절대 위치 (ODBC) 및 레코드 집합: 스크롤 (ODBC).

예외

Exception

Condition

이 메서드가 형식의 예외를 throw 할 수 있습니다 CDBException * 및 CMemoryException*.

요구 사항

헤더: afxdb.h

참고 항목

CRecordset Class
계층 구조 차트
CRecordset::CanBookmark
CRecordset::GetBookmark
CRecordset::SetAbsolutePosition
CDatabase::GetBookmarkPersistence