TDataSet.Prior Method

Moves to the previous record in the dataset.

Pascal

procedure Prior;

C++

__fastcall Prior();

Description

Call Prior to move to the previous record in the dataset, making it the active record. Prior posts any changes to the active record and

Sets the Bof and Eof properties to false.

Fetches the previous record and makes it the active record. If the dataset is unidirectional, it raises an EDatabaseError exception at this point.

Fetches any additional records required for display, such as those needed to fill out a grid control.

Sets the Bof property to true if the first record in the dataset was already active.

Broadcasts the record change so that data controls and linked detail sets can update.

Note: TDataSet uses internal, protected methods to move the active record and to fetch additional records required for display. In TDataSet, these internal methods are empty stubs. Descendant classes implement these methods to enable the Prior method to work.