FireDAC.Stan.Intf.TFDMergeDataMode

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TFDMergeDataMode = (dmNone, dmDataSet, dmDataAppend, dmDataMerge, dmDeltaSet,
dmDeltaAppend, dmDeltaMerge);

C++

enum DECLSPEC_DENUM TFDMergeDataMode : unsigned int { dmNone, dmDataSet, dmDataAppend, dmDataMerge, dmDeltaSet, dmDeltaAppend, dmDeltaMerge };

Properties

Type Visibility Source Unit Parent
enum public
FireDAC.Stan.Intf.pas
FireDAC.Stan.Intf.hpp
FireDAC.Stan.Intf FireDAC.Stan.Intf

Description

Indicates how to merge the data of the specified dataset into this dataset.

This enumeration indicates how to merge the data of the specified dataset into this dataset. The following table lists the possible values:

Mode Description Commit Changes in this Dataset

dmNone

Do not merge the data.

-

dmDataSet

Clears this dataset and inserts records from the specified dataset instead.

Yes

dmDataAppend

Appends records from the specified dataset to this dataset.

Yes

dmDataMerge

Retrieves the primary keys for records from the specified dataset and tries to find their counterparts with the same primary key in this dataset. After this, do one of the following:

  • Updates the records in this dataset with their counterparts from the specified dataset, if any.
  • If a record in the specified dataset has no counterparts in this dataset, the record is appended to this dataset as a new record.
  • Deletes the records for which counterparts are marked as deleted, if any.

Yes

dmDeltaSet

Clears the current dataset and inserts records from the specified dataset instead.

No

dmDeltaAppend

Appends records from the specified dataset to this dataset.

No

dmDeltaMerge

Retrieves the primary keys for records from the specified dataset and tries to find their counterparts with the same primary key in this dataset. After this, do one of the following:

  • Updates the records in this dataset with their counterparts from the specified dataset, if any.
  • If a record in the specified dataset has no counterparts in this dataset, the record is appended to this dataset as a new record.
  • Deletes the records for which counterparts are marked as deleted, if any.

No

See Also