FireDAC.Stan.Intf.TFDMergeMetaMode

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

TFDMergeMetaMode = (mmNone, mmMerge, mmAdd, mmUpdate, mmAddOrError, mmError);

C++

enum DECLSPEC_DENUM TFDMergeMetaMode : unsigned int { mmNone, mmMerge, mmAdd, mmUpdate, mmAddOrError, mmError };

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 metadata of the specified dataset into this dataset.

This enumeration indicates how to merge the metadata (such as the column names, types and sizes) of the specified dataset into this dataset. The following table lists the possible values:

Mode Description
mmNone Do not compare and merge metadata.
mmMerge Retrieves the column names from the specified dataset and tries to find the columns with the same names in this dataset. After this, do one of the following:
  • In this dataset, updates the column data types and sizes with metadata from the specified dataset (only for columns with the same names).
  • If a column with the same name is not found in this dataset, adds a new column to this dataset.
mmAdd Retrieves the column names from the specified dataset and tries to find the columns with the same names in this dataset. If a column with the same name is not found in this dataset, adds a new column to this dataset.
mmUpdate Retrieves the column names from the specified dataset and tries to find the columns with the same names in this dataset. If a column with the same name is found in this dataset, updates the column data types and sizes with metadata from the specified dataset.
mmAddOrError Updates metada in this dataset in the following way:
  • If this dataset has no columns, applies the mmAdd mode.
  • Otherwise, applies the mmError mode.
mmError Retrieves the column names from the specified dataset and tries to find the columns with the same names in this dataset. When not found or when the data types or sizes for columns with the same names do not match, throw an exception.

See Also