CancelUpdate 메서드(ADO)

Update 메서드를 호출하기 전에 Recordset 개체의 현재 행이나 새 행 또는 Record 개체의 Fields 컬렉션 변경 내용을 취소합니다.

구문

  
recordset.CancelUpdaterecord.Fields.CancelUpdate  

설명

레코드 집합

CancelUpdate 메서드를 사용하여 현재 행에 대한 변경 내용을 취소하거나 새로 추가된 행을 삭제합니다. 변경 내용이 RollbackTrans 메서드로 롤백할 수 있는 트랜잭션의 일부이거나 일괄 업데이트의 일부가 아닌 한 Update 메서드를 호출한 후 현재 행 또는 새 행에 대한 변경 내용을 취소할 수 없습니다. 일괄 업데이트의 경우 CancelUpdate 또는 CancelBatch 메서드를 사용하여 Update를 취소할 수 있습니다.

CancelUpdate 메서드를 호출할 때 새 행을 추가하는 경우 현재 행은 AddNew 호출 이전의 현재 행이 됩니다.

편집 모드에 있고 현재 레코드에서 이동하려는 경우(예: Move, NextRecordset 또는 Close 메서드 사용) CancelUpdate를 사용하여 보류 중인 변경 내용을 취소할 수 있습니다. 업데이트가 데이터 원본에 성공적으로 게시될 수 없는 경우 이 작업을 수행해야 할 수 있습니다. 예를 들어 참조 무결성 위반으로 인해 실패한 삭제 시도는 Delete 호출 후 Recordset를 편집 모드로 유지합니다.

레코드

CancelUpdate 메서드는 보류 중인 Field 개체의 삽입 또는 삭제를 취소하고, 기존 필드의 보류 중인 업데이트를 취소하고 원래 값으로 복원합니다. Fields 컬렉션에 있는 모든 필드의 Status 속성이 adFieldOK로 설정됩니다.

적용 대상

Fields 컬렉션(ADO)

레코드 집합 개체(ADO)

참고 항목

Update 및 CancelUpdate 메서드 예제(VB)
Update 및 CancelUpdate 메서드 예제(VC++)
AddNew 메서드(ADO)
Cancel 메서드(ADO)
Cancel 메서드(RDS)
CancelBatch 메서드(ADO)
CancelUpdate 메서드(RDS)
EditMode 속성
Update 메서드