HOME HTML CSS JAVASCRIPT SQL PHP JQUERY XML ASP.NET MORE...
REFERENCES | EXAMPLES | FORUM | ABOUT

ADO WillMove and MoveComplete Events


Recordset Object Reference Complete Recordset Object Reference

The WillMove Event

The WillMove event is triggered before an operation changes the current position in 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 notications.

The MoveComplete Event

The MoveComplete event is triggered after the current position in the Recordset has changed.

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

Note: The WillMove event or MoveComplete event may occur when calling one of  the following Recordset method: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew, and Requery. These events may also occur because of the following properties: Filter, Index, Bookmark, AbsolutePage, and AbsolutePosition.

Syntax

WillMove reason,status,objRs

MoveComplete 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
adRsnMove 10 An operation moved the record pointer within the Recordset
adRsnMoveFirst 12 An operation moved the record pointer to the first record in the Recordset
adRsnMoveNext 13 An operation moved the record pointer to the next record in the Recordset
adRsnMovePrevious 14 An operation moved the record pointer to the previous record in the Recordset
adRsnMoveLast 15 An operation moved the record pointer to the last record in 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

Your suggestion:

Close [X]

Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

WEB BUILDING

Download XML Editor FREE Website BUILDER Free HTML5 Templates

SHARE THIS PAGE