Data.DB.TDataSet.AppendRecord
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
- Data.DB.TDataSet.Append
- Data.DB.TDataSet.InsertRecord
- Data.DB.TDataSet.Post
- Data.DB.TDataSet.SetFields
- Modification d'enregistrements entiers
- Data.DB.TDataSet.OnNewRecord
- Data.DB.TDataSet.AfterInsert