WillChangeRecordset 및 RecordsetChangeComplete 이벤트 (ADO)
보류 중인 작업이 Recordset를 변경하기 전에 WillChangeRecordset 이벤트가 호출됩니다. RecordsetChangeComplete 이벤트는 Recordset가 변경된 후 호출됩니다.
구문
WillChangeRecordset adReason, adStatus, pRecordset
RecordsetChangeComplete adReason, pError, adStatus, pRecordset
매개 변수
adReason
이 이벤트의 이유를 지정하는 EventReasonEnum 값입니다. 해당 값은 adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen일 수 있습니다.
adStatus
EventStatusEnum 상태 값입니다.
WillChangeRecordset가 호출되면 이벤트를 발생시킨 작업이 성공한 경우 이 매개 변수는 adStatusOK로 설정됩니다. 이 이벤트가 보류 중인 작업의 취소를 요청할 수 없는 경우 adStatusCantDeny 로 설정됩니다.
RecordsetChangeComplete이 호출되면 이 매개 변수는 이벤트를 발생시킨 작업이 성공하는 경우 adStatusOK로 설정되고, 작업이 실패하는 경우 adStatusErrorsOccurred로 설정되고, 이전에 허용된 WillChangeRecordset 이벤트와 연결된 작업이 취소된 경우 adStatusCancel로 설정됩니다.
WillChangeRecordset가 반환되기 전에 이 매개 변수를 adStatusCancel로 설정하여 보류 중인 작업의 취소를 요청하거나 이 매개 변수를 adStatusUnwantedEvent로 설정하여 후속 알림을 방지합니다.
WillChangeRecordset 또는 RecordsetChangeComplete가 반환되기 전에 이 매개 변수를 adStatusUnwantedEvent로 설정하여 후속 알림을 방지합니다.
pError
Error 개체입니다. adStatus 값이 adStatusErrorsOccurred인 경우 발생한 오류를 설명합니다. 그렇지 않으면 설정되지 않습니다.
pRecordset
Recordset 개체입니다. 이 이벤트가 발생한 Recordset입니다.
설명
WillChangeRecordset 또는 RecordsetChangeComplete 이벤트는 Recordset Requery 또는 Open 메서드로 인해 발생할 수 있습니다.
공급자가 책갈피를 지원하지 않는 경우 공급자에서 새 행을 검색할 때마다 RecordsetChange 이벤트 알림이 발생합니다. 이 이벤트의 빈도는 RecordsetCacheSize 속성에 따라 달라집니다.
adReason 매개 변수를 포함하는 모든 이벤트에 대한 이벤트 알림을 완전히 중지하려면 가능한 각 adReason 값에 대해 adStatus 매개 변수를 adStatusUnwantedEvent로 설정해야 합니다.