Data.DB.TUpdateRecordEvent

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TUpdateRecordEvent = procedure(DataSet: TDataSet; UpdateKind: TUpdateKind;
var UpdateAction: TUpdateAction) of object;

C++

typedef void __fastcall (__closure *TUpdateRecordEvent)(TDataSet* DataSet, TUpdateKind UpdateKind, TUpdateAction &UpdateAction);

Properties

Type Visibility Source Unit Parent
type
typedef
public
Data.DB.pas
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 your event handler before it exits. On entry into the handler, UpdateAction is always set to uaFail. If your event handler is successful, it should set UpdateAction to uaApplied before exiting.

The code in your event 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.

See Also