CRecordset 클래스

아티클
03/15/2013

데이터 소스에서 선택한 레코드의 집합을 나타냅니다.

class CRecordset : public CObject

멤버

Public 생성자

Name	설명
CRecordset::CRecordset	CRecordset 개체를 생성합니다.파생된 클래스가이 호출 하는 생성자를 제공 해야 합니다.

Public 메서드

Name	설명
CRecordset::AddNew	준비에 대 한 새 레코드를 추가 합니다.호출 Update 추가 완료 합니다.
CRecordset::CanAppend	레코드 집합을 통해 새 레코드를 추가할 수 있습니다 경우 0이 아닌 반환 된 AddNew 멤버 함수.
CRecordset::CanBookmark	책갈피는 레코드 집합을 지 원하는 경우 0이 아닌 값을 반환 합니다.
CRecordset::Cancel	두 번째 스레드가 프로세스 또는 비동기 작업을 취소합니다.
CRecordset::CancelUpdate	때문에 모든 보류 중인 업데이트를 취소는 AddNew 또는 Edit 작업.
CRecordset::CanRestart	0이 아닌 경우 반환 Requery 호출 레코드 집합의 쿼리를 다시 실행할 수 있습니다.
CRecordset::CanScroll	레코드를 스크롤할 수 있는 경우 0이 아닌 값을 반환 합니다.
CRecordset::CanTransact	데이터 소스가 트랜잭션을 지원할 경우 0이 아닌 값을 반환 합니다.
CRecordset::CanUpdate	레코드 집합을 업데이트할 수 있는 경우에 0이 아닌 반환 (추가, 업데이트 하거나 레코드 삭제할 수 있습니다).
CRecordset::CheckRowsetError	레코드를 가져오는 동안 발생 한 오류를 처리 하기 위해 호출 됩니다.
CRecordset::Close	레코드 집합을 닫고 ODBC HSTMT 에 연결 합니다.
CRecordset::Delete	레코드 집합에서 현재 레코드를 삭제합니다.명시적으로 삭제 한 후 다른 레코드로 스크롤해야 합니다.
CRecordset::DoBulkFieldExchange	대량 데이터 원본에서 데이터 레코드 집합 행을 교환 하기 위해 호출 됩니다.대량 레코드 필드 교환을 (Bulk RFX)를 구현 합니다.
CRecordset::DoFieldExchange	(양방향)의 데이터를 데이터 소스에서 해당 레코드와 레코드 집합의 필드 데이터 멤버 간에 교환 하기 위해 호출 됩니다.Implements 필드 교환 RFX ()를 기록합니다.
CRecordset::Edit	변경 내용을 현재 레코드에 대 한 준비합니다.호출 Update 편집을 완료 합니다.
CRecordset::FlushResultSet	다른 결과 이면 0이 아닌 반환 미리 정의 된 쿼리를 사용 하는 경우 검색을 설정 합니다.
CRecordset::GetBookmark	레코드의 책갈피 값을 매개 변수 개체에 할당합니다.
CRecordset::GetDefaultConnect	기본 연결 문자열을 가져오기 위해 호출 됩니다.
CRecordset::GetDefaultSQL	호출 실행에 기본 SQL 문자열을 가져옵니다.
CRecordset::GetFieldValue	레코드 집합에서 필드의 값을 반환합니다.
CRecordset::GetODBCFieldCount	레코드 집합에 필드 수를 반환합니다.
CRecordset::GetODBCFieldInfo	레코드 집합에서 특정 종류의 필드에 대 한 정보를 반환합니다.
CRecordset::GetRecordCount	레코드 집합에서 레코드 개수를 반환합니다.
CRecordset::GetRowsetSize	단일 페치 프로세스에서 검색할 레코드 수를 반환 합니다.
CRecordset::GetRowsFetched	페치 중에 검색 되는 행의 실제 번호를 반환 합니다.
CRecordset::GetRowStatus	반입 된 행의 상태를 반환합니다.
CRecordset::GetSQL	레코드 집합의 레코드를 선택 하는 데 사용 하는 SQL 문자열을 가져옵니다.
CRecordset::GetStatus	레코드 집합의 상태를 가져옵니다: 인덱스의 현재 레코드와 마지막 레코드 개수를 얻은 여부입니다.
CRecordset::GetTableName	레코드 집합의 기반이 되는 테이블의 이름을 가져옵니다.
CRecordset::IsBOF	레코드 집합의 첫 번째 레코드 앞에 배치 된 경우 0이 아닌 값을 반환 합니다.현재 레코드가 됩니다.
CRecordset::IsDeleted	레코드 집합에 삭제 된 레코드에 있으면 0이 아닌 값을 반환 합니다.
CRecordset::IsEOF	레코드 집합의 마지막 레코드 뒤에 배치 된 경우 0이 아닌 값을 반환 합니다.현재 레코드가 됩니다.
CRecordset::IsFieldDirty	현재 레코드에서 지정한 필드를 변경한 경우 0이 아닌 값을 반환 합니다.
CRecordset::IsFieldNull	현재 레코드의 지정 된 필드가 null 이면 0이 아닌 반환 (값이).
CRecordset::IsFieldNullable	현재 레코드에서 지정한 필드 (값이 없는 것)를 null로 설정할 수 있는 경우 0이 아닌 값을 반환 합니다.
CRecordset::IsOpen	0이 아닌 경우 반환 Open 호출 된.
CRecordset::Move	레코드 집합에서에서 현재 레코드에서 지정한 레코드 개수를 배치합니다.
CRecordset::MoveFirst	현재 레코드가 첫 번째 레코드는 레코드 집합에 배치 됩니다.테스트에 대 한 IsBOF 첫 번째.
CRecordset::MoveLast	현재 레코드에서 마지막 레코드 또는 마지막 행에 배치합니다.테스트에 대 한 IsEOF 첫 번째.
CRecordset::MoveNext	다음 레코드 또는 다음 행 집합에서 현재 레코드를 배치합니다.테스트에 대 한 IsEOF 첫 번째.
CRecordset::MovePrev	현재 레코드에 이전 레코드 또는 이전 행 집합에 배치 됩니다.테스트에 대 한 IsBOF 첫 번째.
CRecordset::OnSetOptions	(선택한 사용) 옵션을 설정 하려면 지정한 ODBC 문에 대해 호출 됩니다.
CRecordset::OnSetUpdateOptions	(업데이트 시 사용) 옵션에 대해 지정한 ODBC 문을 설정 하기 위해 호출 됩니다.
CRecordset::Open	테이블을 검색 하거나 레코드 집합을 나타내는 쿼리를 수행 하 여 레코드 집합을 엽니다.
CRecordset::RefreshRowset	데이터 및 지정 된 행의 상태를 새로 고칩니다.
CRecordset::Requery	다시 선택한 레코드를 새로 고치려면 레코드 집합의 쿼리를 실행 합니다.
CRecordset::SetAbsolutePosition	레코드 집합에 지정 된 레코드 번호를 해당 레코드를 배치 합니다.
CRecordset::SetBookmark	레코드 집합에서 책갈피가 지정 된 레코드에 배치 합니다.
CRecordset::SetFieldDirty	지정한 필드는 현재 레코드에 변경 된 것으로 표시 합니다.
CRecordset::SetFieldNull	현재 레코드에 null (값이 없는 필요)에 지정 된 필드의 값을 설정 합니다.
CRecordset::SetLockingMode	"최적" 잠금 (기본값) 또는 "비관적" 잠금 잠금 모드를 설정 합니다.업데이트에 대 한 레코드를 잠그는 방법을 결정 합니다.
CRecordset::SetParamNull	지정한 매개 변수가 null (값이 없는 것)을 설정 합니다.
CRecordset::SetRowsetCursorPosition	지정한 행 집합 내의 행에 커서를 배치합니다.
CRecordset::SetRowsetSize	페치 중에 검색 하려는 레코드 수를 지정 합니다.
CRecordset::Update	완료 되는 AddNew 또는 Edit 작업을 새로 만들거나 편집한 데이터는 데이터 원본에 저장 합니다.

공용 데이터 멤버

Name	설명
CRecordset::m_hstmt	레코드 집합에 대 한 ODBC 명령문 핸들을 포함 합니다.HSTMT를 입력합니다.
CRecordset::m_nFields	레코드 집합의 필드 데이터 멤버를 포함합니다.UINT를 입력합니다.
CRecordset::m_nParams	레코드 집합에서 매개 변수 데이터 멤버를 포함합니다.UINT를 입력합니다.
CRecordset::m_pDatabase	포함에 대 한 포인터는 CDatabase 개체를 통해 레코드 집합에 연결 된 데이터 소스에.
CRecordset::m_strFilter	포함 된 CString 구조적 쿼리 언어 (SQL)를 지정 하는 WHERE 절.필터로 특정 조건에 맞는 레코드만 선택 하는 데 사용 합니다.
CRecordset::m_strSort	포함 된 CString SQL를 지정 하는 ORDER BY 절.레코드 정렬 되는 방식을 제어 하는 데 사용 합니다.

설명

"레코드"로 알려진 CRecordset 개체는 일반적으로 두 가지 형태로 사용: 다이너셋 및 스냅샷.다이너셋은 다른 사용자가 변경한 데이터 업데이트와 동기화 합니다.데이터의 정적 뷰는 스냅숏입니다.각 폼 레코드 집합을 열 때 고정 된 레코드 집합을 나타내지만 다이너셋은 레코드로 스크롤할 때 이후에 레코드를 다른 사용자 또는 다른 응용 프로그램에서 레코드 집합으로 변경 내용을 반영 합니다.

[!참고]

개방형 데이터베이스 연결 (ODBC) 클래스 대신 데이터 액세스 개체 (DAO) 클래스를 작업 하는 경우 클래스 사용 CDaoRecordset 대신 합니다.자세한 내용은 개요: 데이터베이스 프로그래밍.

두 가지 레코드 집합을 사용 하 여 일반적으로 응용 프로그램 특정 레코드 집합 클래스에서 파생 CRecordset.레코드 집합은 데이터 소스에서 레코드를 선택 하 고 있습니다.

레코드를 스크롤할 수 있습니다.
레코드를 업데이트 하 고 잠금 모드를 지정 합니다.
사용 가능한 데이터 소스를 선택 하는 레코드를 제한 하는 레코드 집합을 필터링 합니다.
레코드 집합을 정렬 합니다.
선택을 런타임까지 알 수 없는 정보를 사용자 지정 하는 레코드 집합을 매개 변수화 합니다.

클래스를 사용 하는 데이터베이스를 열고 생성자에 대 한 포인터를 전달 하는 recordset 개체를 만드는 사용자 CDatabase 개체입니다.그런 다음 레코드 집합의 호출 열려 멤버 함수를 개체는 다이너셋 또는 스냅샷 인지 지정할 수 있습니다.호출 열려 데이터 원본에서 데이터를 선택 합니다.레코드 집합 개체를 연 후에 작동 하 고 레코드를 스크롤할 멤버 함수와 데이터 멤버를 사용 합니다.업데이트할 수 있거나 읽기 전용인 지 여부 사용 가능한 작업 개체는 다이너셋 또는 스냅샷 인지에 따라 다릅니다 (개방형 데이터베이스 연결 (ODBC) 데이터 소스의 기능에 따라), 및 대량 행 페치가 구현 여부.변경 했거나 이후 추가 된 레코드를 새로 고칠 수 있는 열기 호출, 호출 개체의 Requery 멤버 함수.호출 개체의 닫기 멤버 함수와 함께 마치면 개체 파괴.

파생 된 CRecordset 클래스, 레코드 필드 교환 (RFX) 또는 대량 레코드 필드 교환 (Bulk RFX) 읽고 레코드 필드의 업데이트를 지원 하는 데 사용 됩니다.

레코드 집합 및 레코드 필드 교환에 대 한 자세한 내용은 문서를 참조 하십시오. 개요: 데이터베이스 프로그래밍, 레코드 집합 (ODBC), 레코드 집합: 레코드 페치 대량 (ODBC), 및 RFX (레코드 필드 교환).스냅샷 및 다이너셋에 초점에 대 한 문서를 참고 하십시오. 다이너셋 및 스냅샷.