Datasnap.DBClient.TCustomClientDataSet.AfterRowRequest

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property AfterRowRequest: TRemoteEvent read FAfterRowRequest write FAfterRowRequest;

C++

__property TRemoteEvent AfterRowRequest = {read=FAfterRowRequest, write=FAfterRowRequest};

Properties

Type Visibility Source Unit Parent
event protected
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Description

Occurs after the client dataset fetches new information about the current record.

Write an AfterRowRequest event handler to respond to custom information returned to the client dataset from a provider's AfterRowRequest event handler. AfterRowRequest is part of the mechanism by which a client dataset and a provider communicate information about data fetching. 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 client dataset fetches detail information about the current record or refreshes the current record, the following events occur:

  1. The client dataset receives a BeforeRowRequest 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 BeforeRowRequest event, where it can respond to or change that information before it looks up the requested information.
  3. The provider creates a delta packet that contains the requested information.
  4. The provider receives an AfterRowRequest event, where it can encode custom information into its OwnerData parameter or respond to information from the BeforeRowRequest event handler.
  5. The client dataset receives an AfterRowRequest event, where it can respond to the custom information returned by the provider's AfterRowRequest event handler.

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

See Also