Data.DB.TDataSet.AppendRecord

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure AppendRecord(const Values: array of const);

C++

void __fastcall AppendRecord(const System::TVarRec *Values, const System::NativeInt Values_High);

Propriétés

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


Description

Ajoute un nouvel enregistrement rempli à la fin de l'ensemble de données et l'expédie.

Appelez AppendRecord pour créer un nouvel enregistrement vide à la fin de l'ensemble de données, le remplir avec les valeurs de champs contenues dans Values et expédier les valeurs dans la base de données ou le journal des modifications.

Dans C++, le paramètre Values est un tableau des valeurs de champ. Le paramètre Values_Size est l'indice de la dernière valeur (un de moins que le nombre total de valeurs).

Un nouvel enregistrement ajouté peut être expédié de trois manières différentes dans la base de données :

Pour les tables Paradox et dBASE indexées, l'enregistrement est inséré dans l'ensemble de données à une position déterminée par l'index.

Pour les tables Paradox et dBASE non indexées, l'enregistrement est ajouté à la fin de l'ensemble de données.

Pour les bases de données SQL, l'emplacement physique de l'ajout est spécifique à l'implémentation. Pour les tables indexées, l'index est actualisé avec les informations du nouvel enregistrement.

L'enregistrement ajouté devient l'enregistrement actif.

Voir aussi

Exemples de code