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

# TDataSet.Post

Post pending edits to the database.

## Declaration

Source position: db.pas line 1327

`public procedure TDataSet.Post; virtual;`

## Description

Post attempts to save pending edits when the dataset is in one of the edit modes: that is, after a Insert, Append or TDataset.Edit operation. The changes will be committed to memory - and usually immediatly to the underlying database as well. Prior to saving the data to memory, it will check some constraints: in TDataset, the presence of a value for all required fields is checked. if for a required field no value is present, an exception will be raised. A call to Post results in the triggering of the BeforePost, AfterPost events. After the call to Past, the State of the dataset is again dsBrowse, i.e. the dataset is again in browse mode.

## Errors

Invoking the post method when the dataset is not in one of the editing modes (dsEditModes) will result in an EdatabaseError exception. If an exception occurs during the save operation, the OnPostError event is triggered to handle the error.

## See also

Insert |  | Insert a new record at the current position.
Append |  | Append a new record to the data
Edit |  | Set the dataset in editing mode.
OnPostError |  | Event triggered when a post operation fails.
BeforePost |  | Event called before changes are posted to the underlying database
AfterPost |  | Event called after changes have been posted to the underlying database
State |  | Current operational state of the dataset

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