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

# TDataSet.Refresh

Refresh the records in the dataset

## Declaration

Source position: db.pas line 1591

`public procedure TDataSet.Refresh;`

## Description

Refresh posts any pending edits, and refetches the data in the dataset from the underlying database, and attempts to reposition the cursor on the same record as it was. This operation is not supported by all datasets, and should be used with care. The repositioning may not always succeed, in which case the cursor will be positioned on the first record in the dataset. This is in particular true for unidirectional datasets. Calling Refresh results in the triggering of the BeforeRefresh and AfterRefresh events.

## Errors

Refreshing may fail if the underlying dataset descendent does not support it.

## See also

TDataset.Close |  | Close the dataset
TDataset.Open |  | Activate the dataset: Fetch data into memory.
BeforeRefresh |  | Event triggered before the data is refreshed.
AfterRefresh |  | Event triggered after the data has been refreshed.

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