Dataset.Insert

Declaration

procedure Insert;

Example

procedure OnMapEvent(var Value:Variant);
begin
DATASET.Insert; //create new record
DATASET['Field1'].Value := 10;
DATASET.Post; //save the record
end;

Description

Creates a new record in the dataset at the end of the existing records. The new record is set as the active record and you can modify its fields through the Field object.

You do not need to call Insert for datasets from a Data Definition (The datasets showing in the source or destination trees). These are managed automatically by the map. You would only use this if working outside of the normal Program Flow (eg adding records onto the dataset beyond the use of LinkedData) or working with Global Datasets

When you are finishing modifying the record you should call Dataset.Post.