FireDAC.Stan.Option.TFDUpdateOptions.RefreshMode

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

property RefreshMode: TFDRefreshMode read GetRefreshMode write SetRefreshMode  stored IsRMS default rmOnDemand;

C++

__property TFDRefreshMode RefreshMode = {read=GetRefreshMode, write=SetRefreshMode, stored=IsRMS, default=1};

Properties

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

Description

Specifies how the dataset should refresh a record after posting an update to it.

Use the RefreshMode property to control how the dataset should refresh a record after posting an update (insert/update) to it.

The default value is rmOnDemand. 

The following table lists modes and their meaning in case of automatic command generation:

Mode 

Description 

rmManual

Do not automatically refresh the record. The application should call RefreshRecord to refresh the record. 

rmOnDemand

Automatically refresh record fields:

  • After inserting, if they are auto-incremental, calculated, have default values, contain ROWID, contain a row version. Or AutoGenerateValue <> arNone.
  • After updating, if they are calculated or contain a row version.

 

rmAll

Automatically refresh all record fields. 

If the dataset is connected to a TFDUpdateSQL and FetchRowSQL is specified, then FireDAC executes the FetchRowSQL command to refresh the row, only if RefreshMode is rmAll.

See Also