FireDAC.Comp.DataSet.TFDDataSet.RefreshUnknownRecord

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

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

Properties

Type Visibility Source Unit Parent
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

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