Data.DB.TUpdateRecordEvent
C++
typedef void __fastcall (__closure *TUpdateRecordEvent)(TDataSet* DataSet, TUpdateKind UpdateKind, TUpdateAction &UpdateAction);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| typedef | public | Data.DB.hpp | Data.DB | Data.DB |
Description
TUpdateRecordEvent is the event handler that updates the records of a dataset.
TUpdateRecordEvent is the event handler that updates the given dataset based on the specified update action.
DataSet is the name of the dataset to which updates are applied.
UpdateKind indicates whether the current update is the insertion of a record, the deletion of a record, or the modification of a record.
UpdateAction indicates the action taken by the OnUpdateRecord handler before it exits. On entry into the handler,
UpdateAction is always set to uaFail. If OnUpdateRecord is successful, it should set
UpdateAction to uaApplied before exiting.
The code in an OnUpdateRecord handler must not call any methods that make a different record the current one.
Note: As an alternate approach, applications can use a client dataset and a provider component to handle cached updates. This alternative provides more support and greater control.