RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomClientDataSet.Reconcile Method

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

Pascal
function Reconcile(const Results: OleVariant): Boolean;
C++
__fastcall Boolean Reconcile(const OleVariant Results);

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 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. 

 

Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!