Data.DB.TDataSet.Append
Delphi
procedure Append;
C++
void __fastcall Append();
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 vide à la fin de l'ensemble de données.
Pour les ensembles de données qui permettent l'édition, appelez Append pour :
1 Ouvrir un nouvel enregistrement vide à la fin de l'ensemble de données.
2 Faire de ce nouvel enregistrement, l'enregistrement actif.
Après l'appel de Append, une application peut autoriser les utilisateurs à saisir des données dans les champs de l'enregistrement, puis expédier ces modifications dans la base de données ou dans le journal des modifications en utilisant Post (les ensembles de données client peuvent par la suite appliquer les mises à jour du journal des modifications dans la base de données en appelant ApplyUpdates). 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'enregistrement ajouté dépend de l'implémentation. Pour les tables indexées, l'index est actualisé avec les informations du nouvel enregistrement.
Lorsqu'un nouvel enregistrement est appliqué sur le serveur de base de données, son emplacement physique est spécifique à la base de données. Pour les tables indexées, l'index est actualisé avec les informations du nouvel enregistrement.