Skip to content

TDataSetState

Current state of the dataset.

Declaration

Source position: db.pas line 55

type
  TDataSetState = (dsInactive,dsBrowse,dsEdit,dsInsert,dsSetKey,
                 dsCalcFields,dsFilter,dsNewValue,dsOldValue,dsCurValue,
                 dsBlockRead,dsInternalCalc,dsOpening,dsRefreshFields)

Values

Value Description
dsInactive The dataset is not active. No data is available.
dsBrowse The dataset is active, and the cursor can be used to navigate the data.
dsEdit The dataset is in editing mode: the current record can be modified.
dsInsert The dataset is in insert mode: the current record is a new record which can be edited.
dsSetKey The dataset is calculating the primary key.
dsCalcFields The dataset is calculating it's calculated fields.
dsFilter The dataset is filtering records.
dsNewValue The dataset is showing the new values of a record.
dsOldValue The dataset is showing the old values of a record.
dsCurValue The dataset is showing the current values of a record.
dsBlockRead The dataset is open, but no events are transferred to datasources.
dsInternalCalc The dataset is calculating it's internally calculated fields.
dsOpening The dataset is currently opening, but is not yet completely open.
dsRefreshFields Dataset is refreshing field values from server after an update.

Description

TDataSetState describes the current state of the dataset. During it's lifetime, the dataset's state is described by these enumerated values.

Some state are not used in the default TDataset implementation, and are only used by certain descendents.

See also

Name Description
TDataset.State Current operational state of the dataset.