RAD Studio VCL Reference
TCustomADODataSet.OnRecordChangeComplete Event

Occurs after one or more records in the recordset change.

property OnRecordChangeComplete: TRecordChangeCompleteEvent;
__property TRecordChangeCompleteEvent OnRecordChangeComplete;

Write an OnRecordChangeComplete event handler to take specific action after one or more rows in the dataset component's Recordset object have changed. 

DataSet is the ADO dataset component that triggered the OnRecordChangeComplete event. This dataset component also contains the recordset in question. 

Reason indicates the type of change that triggered the event. While the TEventReason type contains more constants, the value of Reason for an OnRecordChangeComplete event is limited to: erAddNew, erDelete, erUpdate, erUndoUpdate, erUndoAddNew, erUndoDelete, and erFirstChange. 

RecordCount is the number of records that were changed. 

Error is an ADO Error object. See the Microsoft Data Access SDK for more information on using ADO Error objects. The Error parameter is only set if an error occurred during execution of the operation that triggered the event. In this case, the EventStatus parameter will contain the value esErrorsOccured. 

The EventStatus value (ADO EventStatusEnum) indicates the success or failure of the execution of the operation that triggered the event.

Note: : The OnRecordChangeComplete event is purely a Recordset object event and independent of any VCL data change events.


Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!