FireDAC.Comp.DataSet.TFDDataSet.Reconcile

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function Reconcile(ASuccess: Boolean = True): Boolean;

C++

bool __fastcall Reconcile(bool ASuccess = true);

Properties

Type Visibility Source Unit Parent
function public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Clears the successfully updated records from the dataset's cache of changes.

Reconcile is called by the ApplyUpdates method to update the dataset so that it reflects the result of an update.

Reconcile is called after the dataset has attempted to apply all the updates in the dataset's Delta property. 

The results of applying updates are recorded in the internal data storage, including error information for each record that could not be applied. Reconcile generates an OnReconcileError event for every record that was not successfully applied. Finally, Reconcile adjusts the Delta property so that it includes only those records that were not successfully applied. Any changes made in the OnReconcileError event are reflected in the new value of Delta

Reconcile returns a value that indicates whether reconciling is successful. If True, Reconcile succeeded without error. If False, one or more errors could not be reconciled. 

Alternatively, an application can review erroneous records using the FilterChanges and RowError properties. See Reviewing Errors for more details.

See Also