CancelBatch 메서드(ADO)

보류 중인 일괄 업데이트를 취소합니다.

구문

  
recordset.CancelBatchAffectRecords  

매개 변수

AffectRecords
(선택 사항) CancelBatch 메서드가 영향을 줄 레코드 수를 나타내는 AffectEnum 값입니다.

설명

CancelBatch 메서드를 사용하여 일괄 업데이트 모드의 레코드 집합에서 보류 중인 업데이트를 취소합니다. 레코드 집합이 즉시 업데이트 모드인 경우 adAffectCurrent 없이 CancelBatch를 호출하면 오류가 발생합니다.

현재 레코드를 편집하거나 CancelBatch를 호출할 때 새 레코드를 추가하는 경우 ADO는 먼저 CancelUpdate 메서드를 호출하여 캐시된 변경 내용을 취소합니다. 그런 다음, 레코드 집합의 보류 중인 모든 변경 내용이 취소됩니다.

특히 새 레코드를 추가하는 중인 경우 CancelBatch 호출 후 현재 레코드가 확정되지 않을 수 있습니다. 따라서 CancelBatch 호출 후 현재 레코드 위치를 레코드 집합의 알려진 위치로 설정하는 것이 좋습니다. 예를 들어 MoveFirst 메서드를 호출합니다.

기본 데이터와의 충돌로 인해 보류 중인 업데이트 취소 시도가 실패하는 경우(예: 다른 사용자가 레코드를 삭제한 경우) 공급자는 Errors 컬렉션에 경고를 반환하지만 프로그램 실행을 중단하지는 않습니다. 런타임 오류는 요청된 모든 레코드에 충돌이 있는 경우에만 발생합니다. Filter 속성(adFilterAffectedRecords) 및 Status 속성을 사용하여 충돌이 있는 레코드를 찾습니다.

적용 대상

레코드 집합 개체(ADO)

참고 항목

UpdateBatch 및 CancelBatch 메서드 예제(VB)
UpdateBatch 및 CancelBatch 메서드 예제(VC++)
Cancel 메서드(ADO)
Cancel 메서드(RDS)
CancelUpdate 메서드(ADO)
CancelUpdate 메서드(RDS)
Clear 메서드(ADO)
LockType 속성(ADO)
UpdateBatch 메서드