Data.DB.TDataSet.AppendRecord
Delphi
procedure AppendRecord(const Values: array of const);
C++
void __fastcall AppendRecord(const System::TVarRec *Values, const int Values_High);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
procedure function |
public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Description
Adds a new, populated record to the end of the dataset and posts it.
Call AppendRecord to create a new, empty record at the end of the dataset, populate it with the field values in Values, and post the values to the database or change log.
In C++, the Values parameter is an array of field values. The Values_Size parameter is the index of the last value (one less than the total number of values).
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 append is implementation-specific. For indexed tables, the index is updated with the new record information.
The newly appended record becomes the active record.
See Also
- Data.DB.TDataSet.Append
- Data.DB.TDataSet.InsertRecord
- Data.DB.TDataSet.Post
- Data.DB.TDataSet.SetFields
- Modifying Entire Records
- Data.DB.TDataSet.OnNewRecord
- Data.DB.TDataSet.AfterInsert