Data.DB.TDataLink.BOF

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property BOF: Boolean read GetBOF;

C++

__property bool BOF = {read=GetBOF, nodefault};

Properties

Type Visibility Source Unit Parent
property public
Data.DB.pas
Data.DB.hpp
Data.DB TDataLink

Description

Indicates whether the first record in a dataset is active.

Inspect BOF to determine if the dataset component associated with the TDataLink is positioned on its first record. If BOF is true, the active record is unequivocally the first row in the dataset. BOF is also true when:

A dataset is first opened.

A call is made to the dataset's First method.

A call is made to the dataset's Prior method, and the method fails because the first row is already active.

A call is made to the dataset's SetRange, resulting in an empty result set.

BOF is false in all other cases. An application should assume BOF is false unless one of the conditions above is met and the application tests the property directly.

Tip: If both Eof and BOF are true, a dataset or range is empty.

See Also