Data.DB.TDataSet.CurrentRecord

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property CurrentRecord: Integer read FCurrentRecord;

C++

__property int CurrentRecord = {read=FCurrentRecord, nodefault};

Properties

Type Visibility Source Unit Parent
property protected
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet

Description

Indicates the index of the current record in the internal cache of record buffers.

Most TDataSet descendants maintain an internal cache of records from the underlying database table. For example, if the dataset is used to populate a data-aware grid, the cache includes a record for each row in the grid. CurrentRecord indicates the offset in this cache of the record buffer for the current record.

The current record is the record currently in use by the dataset. This can differ from the active record (which the end user sees as active) when the dataset performs operations involving other records. For example, when painting a data-aware grid, CurrentRecord cycles through all the visible records, while ActiveRecord remains constant.

Note: For unidirectional datasets, CurrentRecord is meaningless.

See Also