Data.DB.TDataSet.BlockReadSize

From RAD Studio 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.

See Also