Datasnap.DBClient.TCustomClientDataSet.Reconcile
Delphi
function Reconcile(const Results: OleVariant): Boolean;
C++
bool __fastcall Reconcile(const System::OleVariant &Results);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Clears successfully updated records from the client dataset's cache of changes.
Reconcile is called by the ApplyUpdates method to update the client dataset so that it reflects the result of an update. Reconcile is called after the provider has attempted to apply all updates in the client dataset's Delta property. (The provider may be internal to the client dataset, an external component in the same application as the client dataset, or on a separate application server.)
Results is a Variant, returned by the ApplyUpdates method of a provider, that contains error information and record information for each record that could not be applied. Reconcile generates an OnReconcileError event for every record in Results (every record that was not successfully applied by the provider). Finally, Reconcile adjusts the Delta property so that it includes only those records that were not successfully applied. Any changes made in theOnReconcileError 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.