Data.DB.TDataSet.BlockReadSize
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.