Data.DB.TDataSet.AppendRecord

From RAD Studio API Documentation
Jump to: navigation, search

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

Code Examples