FireDAC.Comp.DataSet.TFDDataSet.RefreshUnknownRecord

From RAD Studio API Documentation
Jump to: navigation, search

[–] Properties
Type:
procedure
function
Visibility: public
Source:
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
Unit: FireDAC.Comp.DataSet
Parent: TFDDataSet

Delphi

procedure RefreshUnknownRecord(const AValues: array of Variant;
AReread: Boolean = True; ASetPos: Boolean = True);

C++

void __fastcall RefreshUnknownRecord(const System::Variant *AValues, const System::NativeInt AValues_High, bool AReread = true, bool ASetPos = true);

Description

Registers a new record and optionally rereads its field values from a data source.

Use RefreshUnknownRecord to register a new record not yet fetched at internal data storage, assign AValues to its columns, and optionally reread its field values from data source.   This method is useful if you need to fetch a record that does not exist in the internal data storage, but exists in the database. For example, a new record that was not fetched together with the result set, but later it is known that this record is added to the database and the application needs to fetch it. 

FireDAC assigns non-null values from AValues to the corresponding record columns. Only those columns values will be used in the WHERE phrase at the fetching record. The best approach is to specify the key column values.

See Also