FireDAC.Stan.Option.TFDFetchOptions.Unidirectional

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property Unidirectional: Boolean read GetUnidirectional  write SetUnidirectional stored IsUS default False;

C++

__property bool Unidirectional = {read=GetUnidirectional, write=SetUnidirectional, stored=IsUS, default=0};

Properties

Type Visibility Source Unit Parent
property published
FireDAC.Stan.Option.pas
FireDAC.Stan.Option.hpp
FireDAC.Stan.Option TFDFetchOptions

Description

Specifies possible directions of navigation by dataset records.

Use the Unidirectional property to specify whether an application will navigate by dataset records in forward-only direction or in forward, backward and random directions. To change Unidirectional for an already used dataset, an application can call the Disconnect method first. 

Setting Unidirectional to True enables an application to navigate in forward-only direction. FireDAC will automatically discard prior rows from the internal data storage after moving the current position in the dataset, because they are not needed anymore. This dramatically reduces memory consumption on big result sets.  Setting Unidirectional to True for TFDTable disables the live data window mode.

Note: Do not use Unidirectional datasets to display data in grid control. It requires bi-directional datasets.

The Unidirectional property is synchronized with IsUniDirectional.

See Also