Datasnap.DBClient.TClientDataSet.AfterApplyUpdates

• Up to Parent: TClientDataSet

Delphi

property AfterApplyUpdates: TRemoteEvent read FAfterApplyUpdates write FAfterApplyUpdates;

C++

__property AfterApplyUpdates;

Properties

Type	Visibility	Source	Unit	Parent
event	published	Datasnap.DBClient.pas Datasnap.DBClient.hpp	Datasnap.DBClient	TClientDataSet

Description

Occurs after the client dataset applies updates to the provider but before it attempts to reconcile update errors.

Datasnap.DBClient.TClientDataSet.AfterApplyUpdates inherits from Datasnap.DBClient.TCustomClientDataSet.AfterApplyUpdates. All content below this line refers to Datasnap.DBClient.TCustomClientDataSet.AfterApplyUpdates.

Occurs after the client dataset applies updates to the provider but before it attempts to reconcile update errors.

Write an AfterApplyUpdates event handler to respond to custom information returned to the client dataset from a provider's AfterApplyUpdates event handler. AfterApplyUpdates is part of the mechanism by which a client dataset and a provider communicate information about updates. When working with a provider on a stateless application server, this mechanism allows the client dataset and the provider to communicate persistent state information.

When the application calls the client dataset's ApplyUpdates method, the following events occur:

1. The client dataset receives a BeforeApplyUpdates event, where it can encode custom information into an OleVariant that is passed to the provider as the OwnerData parameter.
2. The provider receives a BeforeApplyUpdates event, where it can respond to or change that information before it applies the updates.
3. The provider applies the updates, and receives an OnUpdateError event for any problem records.
4. The provider receives an AfterApplyUpdates event, where it can encode custom information into its OwnerData parameter or respond to information from the BeforeApplyUpdates event handler.
5. The client dataset receives an AfterApplyUpdates event, where it can respond to the custom information returned by the provider in its AfterApplyUpdates event handler.
6. The client dataset generates an OnReconcileError for every record that could not be applied by the provider.

AfterApplyUpdates is an event handler of type Datasnap.DBClient.TRemoteEvent.

See Also

• Datasnap.DBClient.TRemoteEvent

• ApplyUpdates

• Midas.IAppServer.AS_ApplyUpdates

• Datasnap.Provider.TCustomProvider.ApplyUpdates

• Datasnap.Provider.TCustomProvider.AfterApplyUpdates

• Datasnap.Provider.TBaseProvider.OnUpdateError

• BeforeApplyUpdates

• OnReconcileError

• Applying Updates

• Communicating with the Client Dataset