[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'db' (#fcl)

# TDataSet.Insert

Insert a new record at the current position.

## Declaration

Source position: db.pas line 1316

`public procedure TDataSet.Insert;`

## Description

Insert will insert a new record at the current position. When this function is called, any pending modifications (when the dataset already is in insert or edit mode) will be posted. After that, the BeforeInsert, BeforeScroll, OnNewRecord, AfterInsert and AfterScroll events are triggered in the order indicated here. The dataset is in the dsInsert state after this method is called, and the contents of the various fields can be set. To write the new record to the underlying database TDataset.Post must be called.

## Errors

If the dataset is read-only, calling Insert will result in an EDatabaseError.

## See also

BeforeInsert |  | Event triggered before the dataset is put in insert mode.
BeforeScroll |  | Event triggered before the cursor changes position.
OnNewRecord |  | Event triggered when a new record is created.
AfterInsert |  | Event triggered after the dataset is put in insert mode.
AfterScroll |  | Event triggered after the cursor has changed position.
TDataset.Post |  | Post pending edits to the database.
TDataset.Append |  | Append a new record to the data

The latest version of this document can be found at lazarus-ccr.sourceforge.net .