The WillChangeRecord and RecordChangeComplete Events

HOME

ADO Tutorial
ADO HOME
ADO Intro
ADO Connect
ADO Recordset
ADO Display
ADO SQL
ADO Demo

ADO Objects
ADO Command
ADO Connection
ADO Error
ADO Field
ADO Parameter
ADO Property
ADO Record
ADO Recordset
ADO Stream

Examples
ADO Examples

Please visit our sponsors !

The WillChangeRecord and RecordChangeComplete Events

The WillChangeRecord Event

The WillChangeRecord event is triggered before one or more record changes.

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 notications.

The RecordChangeComplete Event

The RecordChangeComplete event is triggered after one or more record have been changed.

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

Note: The WillChangeRecord event or the RecordChangeComplete event may occur if you change a field in a record using one of the following Recordset operations: Update, Delete, CancelUpdate, AddNew, UpdateBatch, and CancelBatch.

Syntax

WillChangeRecord reason,numrec,status,objRs

RecordChangeComplete reason,numrec,objErr,status,objRs

Parameter	Description
reason	An EventReasonEnum value that specifies the reason for this event
numrec	Indicates the number of records affected
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
adRsnAddNew	1	An operation added a new record
adRsnDelete	2	An operation deleted a record
adRsnUpdate	3	An operation updated an existing record
adRsnUndoUpdate	4	An operation reversed the update of a record
adRsnUndoAddNew	5	An operation reversed the addition of a new record
adRsnUndoDelete	6	An operation reversed the deletion of a record
adRsnFirstChange	11	An operation made the first change to a record

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

Jump to: Top of Page or HOME or Printer friendly page

Search W3Schools:

What Others Say About Us

Does the world know about us? Check out these places:

Dogpile Alta Vista MSN Google Excite Lycos Yahoo Ask Jeeves

We Help You For Free. You Can Help Us!

W3Schools is for training only. We do not warrant its correctness or its fitness for use. The risk of using it remains entirely with the user. While using this site, you agree to have read and accepted our terms of use and privacy policy.

How we converted to XHTML

Domain Name
Registration & More!

Your own Web Site?

Read W3Schools
Hosting Tutorial

$15 Domain Name
Registration
Save $20 / year!

Advertise
at W3Schools

Only 0.5 CPM

SELECTED LINKS

University Online
Master Degree
Bachelor Degree

Web Software

The Future of
Web Development

Jobs and Careers

Web Security
Web Statistics
Web Standards

PARTNERS

W3Schools
TopXML
VisualBuilder
XMLPitstop
DevelopersDex
DevGuru
Programmers Heaven
The Code Project
Tek Tips Forum
ZVON.ORG
TopXML Search