Bde.DBTables.TBatchMove.Destination

From RAD Studio API Documentation
Jump to: navigation, search

[–] Properties
Type: property
Visibility: published
Source:
Bde.DBTables.pas
Bde.DBTables.hpp
Unit: Bde.DBTables
Parent: TBatchMove

Delphi

property Destination: TTable read FDestination write FDestination;

C++

__property TTable* Destination = {read=FDestination, write=FDestination};

Description

Specifies the TTable object for the database table that is the destination of the batch operation.

Use Destination to indicate the database table that will be created or altered by the batch operation. The batch operation affects the Destination differently depending on the Mode:



Mode Effect on Destination

batAppend

Records are added to the destination table. No pre-existing records are altered. Destination table must already exist.

batUpdate

Records in the destination table with key fields matching the corresponding fields in the source are changed to match the source records. No new records are added. Destination table must already exist and must have an index defined.

batAppendUpdate

Records in the destination table with key fields matching the corresponding fields in the source are changed to match the source. Source records that do not match key fields are added to the destination table. Destination table must already exist and must have an index defined.

batDelete

Records in the destination table that match the records in the source are deleted. Destination table must already exist and must have an index defined.

batCopy

Destination table is created to match the records in the source. If Destination already exists, it is replaced by the copy of the source.



See Also