TCustomADODataSet.OnFieldChangeComplete Event

Occurs after a field has changed.

Pascal

property OnFieldChangeComplete: TFieldChangeCompleteEvent;

C++

__property TFieldChangeCompleteEvent OnFieldChangeComplete;

Description

Write an OnFieldChangeComplete event handler to take specific action before a pending operation changes the value of one or more ADO Field objects in the Recordset object. (The term "Field object" as used here refers to the ADO Field object, not VCL persistent field objects that descend from TField.)

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

FieldCount is the number of ADO Field objects in the Fields parameter.

Fields is an array of Variants representing the ADO Field objects about to be changed by the operation. See the Microsoft Data Access SDK for more information on using ADO Field objects.

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: A Recordset object's Field objects are distinct from the VCL field objects of its ADO dataset component. The OnFieldChangeComplete event is purely a Recordset object event and independent of any VCL field change events.