FireDAC.Comp.DataSet.TFDDataSet.DoReconcile

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function DoReconcile(AOnSuccess, ACommitApplied: Boolean): Boolean;

C++

bool __fastcall DoReconcile(bool AOnSuccess, bool ACommitApplied);

Properties

Type Visibility Source Unit Parent
function protected
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.

Reconciled changes are commited if any of the following conditions are met:

DoReconcile is called by ApplyUpdates method to update the dataset so that it reflects the result of an update, after the dataset has attempted to apply all the updates in the dataset's Delta property. Reconcile calls DoReconcile as well.

The results of applying updates are recorded in the internal data storage, including error information for each record that could not be applied. DoReconcile generates an OnReconcileError event for every record that was not successfully applied. Finally, DoReconcile 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.

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