Show: Delphi C++
Display Preferences

Data.DB.TDataSet.Append

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Append;

C++

void __fastcall Append();

Properties

Type Visibility Source Unit Parent
procedure
function
public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet

Description

Adds a new, empty record to the end of the dataset.

For datasets that permit editing, call Append to:

1Open a new, empty record at the end of the dataset.

2Set the active record to the new record.

After a call to Append, an application can enable users to enter data in the fields of the record, and can then post those changes to the database or change log using Post (Client datasets can subsequently apply updates in the change log back to the database by calling ApplyUpdates.) A newly appended record is posted to the database in one of three ways:

For indexed Paradox and dBASE tables, the record is inserted into the dataset in a position based on its index.

For unindexed Paradox and dBASE tables, the record is added to the end of the dataset.

For SQL databases, the physical location of the appended record is implementation-specific. For indexed tables, the index is updated with the new recordinformation.

After the new record is applied back to the database server, its physical location is database-specific. For indexed tables, the index is updated with the new record information.

See Also


Code Examples

Personal tools
In Other Languages
Previous Versions
Assistance