Data.DB.TDataSet.First

• Up to Parent: TDataSet

Delphi

procedure First;

C++

void __fastcall First(void);

Properties

Type	Visibility	Source	Unit	Parent
procedure function	public	Data.DB.pas Data.DB.hpp	Data.DB	TDataSet

Description

Moves to the first record in the dataset.

Call First to make the first record in the dataset active. First posts any changes to the active record and:

• Clears the record buffers.
• Fetches the first record and makes it the active record.
• Fetches any additional records required for display, such as those needed to fill out a grid control.
• Sets the Bof property to true.
• Broadcasts the record change so that data controls and linked detail sets can update.

Note: The TDataSet class uses internal protected methods to reposition the active record and to fetch additional records required for display. In TDataSet, these internal methods are empty stubs. Implement these methods in derived classes to enable the First method to work.

See Also

• Last

• MoveBy

• Next

• Prior

• Posting Data

• Using the Eof and Bof Properties

• Using the First and Last Methods

• Using Unidirectional Result Sets

Code Examples

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