W3Schools.com

ADO WillChangeRecordset and RecordsetChangeComplete Events


Recordset Object Reference Complete Recordset Object Reference

The WillChangeRecordset Event

The WillChangeRecordset event is triggered before an operation changes the Recordset.

Note: Before this event returns, set the status parameter to adStatusCancel to cancel the operation that caused this event or set it to adStatusUnwantedEvent to prevent subsequent notifications.

The RecordsetChangeComplete Event

The RecordsetChangeComplete event is triggered after a Recordset has changed.

Note: Before this event returns, set the status parameter to adStatusUnwantedEvent to prevent subsequent notifications.

Note: The WillChangeRecordset and the RecordsetChangeComplete event can occur when calling the Requery method or the Open method of a Recordset object.

Syntax

WillChangeRecord reason,status,objRs

RecordsetChangeComplete reason,objErr,status,objRs

Parameter Description
reason An EventReasonEnum value that specifies the reason for this event
status An EventStatusEnum value that indicates the status of the execution of the event
objErr The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set
objRs The name of the Recordset object that triggered this event


EventReasonEnum Values

Constant Value Description
adRsnRequery 7 An operation requeried the Recordset
adRsnResynch 8 An operation resynchronized the Recordset with the database
adRsnClose 9 An operation closed the Recordset


EventStatusEnum Values

Constant Value Description
adStatusOK 1 The operation that caused the event was successful
adStatusErrorsOccurred 2 The operation that caused the event failed
adStatusCantDeny 3 The operation that caused the event cannot be cancelled
adStatusCancel 4 The operation that caused the event is cancelled
adStatusUnwantedEvent 5 Prevents subsequent notifications before the event method has finished executing


Recordset Object Reference Complete Recordset Object Reference
WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE