Vcl.DBClientActns.TClientDataSetApply.ExecuteTarget

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure ExecuteTarget(Target: TObject); override;

C++

virtual void __fastcall ExecuteTarget(System::TObject* Target);

Properties

Type Visibility Source Unit Parent
procedure
function
public
Vcl.DBClientActns.pas
Vcl.DBClientActns.hpp
Vcl.DBClientActns TClientDataSetApply

Description

Applies any updates the target client dataset has cached in its change log.

You can call ExecuteTarget directly to execute this action, or it can be called automatically when the action fires in response to a user action (for example, when the user selects a menu item or presses a tool button that is linked to this action).

ExecuteTarget checks that Target is a data source component whose DataSet property references a TClientDataSet instance. If the DataSource property is set, Target must be the same data source.

If Target is a valid data source, ExecuteTarget calls the associated client dataset's ApplyUpdates method, passing in the value of the MaxErrors property. If the client dataset encounters errors applying its updates, and if the DisplayErrorDlg property is true, then TClientDataSetApply responds to those errors by displaying a dialog where the user can indicate how to handle them.

See Also