RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TCustomProvider.RowRequest Method

Returns information from a specified record.

Pascal
function RowRequest(const Row: OleVariant; RequestType: Integer; var OwnerData: OleVariant): OleVariant; virtual;
C++
virtual __fastcall OleVariant RowRequest(const OleVariant Row, int RequestType, OleVariant OwnerData);

RowRequest is called automatically in response to the client dataset's FetchBlobs, FetchDetails, or RefreshRecord method. It generates a BeforeRowRequest event, assembles the requested information, and generates an AfterRowRequest event. 

The Row parameter is an OleVariant that describes the record about which information is requested. It enables the provider to locate the record of interest. 

The RequestType parameter indicates the type of information required. It is an integer version of the TFetchOptions type. (Its an integer because the value must be marshaled over an IAppServer interface). In Delphi, to convert the TFetchOptions value to the appropriate integer, use the Ord function. In C++, to combine TFetchOption values, use the bitwise "or" operator. For example:

Ord(foBlobs) + Ord(foDetails);

 

foBlobs || foDetails

RowRequest returns the requested information in a delta packet. 

As implemented in TCustomProvider, RowRequest always returns NULL. Descendant classes override this method to return the requested data. 

 

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