Datasnap.DBClient.TReconcileErrorEvent

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TReconcileErrorEvent = procedure(DataSet: TCustomClientDataSet; E: EReconcileError;
UpdateKind: TUpdateKind; var Action: TReconcileAction) of object;

C++

typedef void __fastcall (__closure *TReconcileErrorEvent)(TCustomClientDataSet* DataSet, EReconcileError* E, Data::Db::TUpdateKind UpdateKind, TReconcileAction &Action);

Properties

Type Visibility Source Unit Parent
type
typedef
public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient Datasnap.DBClient

Description

TReconcileErrorEvent is the type for event handlers that handle update errors for a client dataset.

TReconcileErrorEvent is the type for event handlers that respond when a client dataset receives a set of update errors from a provider.

DataSet is a client dataset that contains the record that generated an update error. If the error occurred while updating a nested detail dataset in a master/detail relationship, DataSet represents the detail dataset although the event occurs on the master dataset. Do not use any methods that change the current record of DataSet (such as Next or Prior). You can, however, use the NewValue, OldValue, and CurValue properties of DataSet’s fields to obtain more information about the update error.

E is a pointer to an EReconcileError object from which you can extract an error message and the cause of the error condition. An OnReconcileError handler can use this information to determine how to respond to the error condition.

UpdateKind describes the type of update (insertion, deletion, or modification) that generated the error.

Action indicates the action to take when the OnReconcileError handler exits. If OnReconcileError can handle or correct the error, set Action to raCorrect before exiting the error handler.

See Also