Skip to main content

Edit

procedure Edit;

Example​

procedure ChangeStatus(const Data: TvxClientDataSet);
begin
  Data.Edit;
  try
    Data.FieldByName('Status').AsString := 'Complete';
    Data.Post;
  except
    Data.Cancel;
    raise;
  end;
end;

Usage​

Places the current record into edit state, or starts an insert when the active dataset is empty.

  • Verify Active, nonempty intent and modify permission; an empty dataset creates a new pending record.
  • Pair field changes with explicit Post/Cancel exception handling.
  • Edit does not lock a database row by contract and does not begin a SQL transaction.

Additional Technical Info​

Edit is declared by hidden ancestor TDataSet and is normally used through a visible descendant such as TvxClientDataSet. Writable field assignments require edit or insert state.

Source-backed behaviour​

If already in edit/insert state, the method does nothing. If the active buffer has no records, it calls Insert. Otherwise it checks browse mode and modify permission, runs before-edit and parent/detail coordination, invokes descendant InternalEdit through the edit-error retry/abort handler, calculates fields, sets state dsEdit, emits record-change and runs after-edit.

CheckBrowseMode can post a prior modified record or cancel an unmodified one before this edit begins.

Modified reports whether the current edit buffer changed. Post accepts and Cancel abandons it.

Official RTL references​

Created 2026-07-15