Show: Delphi C++
Display Preferences

Data.DB.TDataSet.BlockReadSize

From XE2 API Documentation
Jump to: navigation, search

Delphi

property BlockReadSize: Integer read FBlockReadSize write SetBlockReadSize;

C++

__property int BlockReadSize = {read=FBlockReadSize, write=SetBlockReadSize, nodefault};

Properties

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

Description

Determines how many record buffers are read in each block.

Setting BlockReadSize to a value greater than 0 puts the dataset in the dsBlockRead state. It remains in that state until you set BlockReadSize to 0 or change the dataset's state in some other manner (such as putting it in edit mode).

For all TDataSet descendants, data-aware controls are not updated and data events are not triggered when the dataset is in the dsBlockRead state. Thus, you can set BlockReadSize to a positive value to scan through the entire dataset quickly without updating data-aware controls.

For BDE-enabled datasets, setting BlockReadSize also causes the dataset to fetch database information in blocks of BlockReadSize records, which it then buffers. This minimizes traffic between your application and the database server.

See Also

Personal tools
Previous Versions
Translations