Data.DB.TDataSet.Next

• Up to Parent: TDataSet

[–] Properties Type:

procedure

function

Visibility: public Source:

Data.DB.pas

Data.DB.hpp

Unit: Data.DB Parent: TDataSet

Delphi

procedure Next;

C++

void __fastcall Next();

Description

Moves to the next record in the dataset.

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

Sets the Bof and Eof properties to false.

Fetches the next record and makes it the active record.

If the dataset is not unidirectional, fetches any additional records required for display, such as those needed to fill out a grid control.

Sets the Eof property to true if the last 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 Next method to work.

See Also

• First

• Last

• MoveBy

• Prior

• Adding New Records

• Posting Data

• Using the Eof and Bof Properties

• Using the Next and Prior Methods

• Using Unidirectional Result Sets

Code Examples

• RecordCount (C++)
• RecordCount (Delphi)