RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TClientDataSetApply Class

TClientDataSetApply causes a target client dataset to apply the updates in its change log.

Pascal
TClientDataSetApply = class(TDataSetAction);
C++
class TClientDataSetApply : public TDataSetAction;

Add TClientDataSetApply to an action list or action manager to allow users to apply the updates that a client dataset caches. Controls such as menu items and tool buttons linked to this action cause the target dataset to apply the updates in its change log. If you set the DisplayErrorDlg property to true, then if the applying of updates results in errors, TClientDataSetApply displays an error dialog so that the user can indicate how to respond to those errors. 

TClientDataSetApply is designed to work with a target that is a TDataSource component whose dataset is a TClientDataSet instance. You can explicitly provide this target by setting the DataSource property, or you can allow the action to infer the data source from an active data-aware control. TClientDataSetApply automatically disables itself if it does not have a target data source attached to an active client dataset. 

TClientDatasetApply action automatically generates a reconcile error dialog, so you do not have to write any code to invoke the dialog. Typically, you would assign the OnReconcileError (TClientDataset ) event and write the code to invoke the dialog. 

 

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