Data.DB.TDataSet.InsertRecord

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure InsertRecord(const Values: array of const);

C++

void __fastcall InsertRecord(const System::TVarRec *Values, const int Values_High);

Propriétés

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


Description

Insère un nouvel enregistrement rempli dans l'ensemble de données et le valide.

Appelez la méthode InsertRecord pour créer un nouvel enregistrement vide dans l'ensemble de données, le remplir avec les valeurs de champs de Values et expédier les valeurs dans la base de données ou le journal des modifications. Dans C++, le paramètre Values_Size indique l'indice de la dernière valeur dans le tableau Values (un de moins que le nombre de valeurs).

Un nouvel enregistrement inséré 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 non indexées Paradox, l'enregistrement est ajouté dans l'ensemble de données à la position en cours.

Pour les tables non indexées dBASE, FoxPro et Access, 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 dépend de l'implémentation. Pour les tables indexées, l'index est actualisé avec les informations du nouvel enregistrement.

L'enregistrement inséré devient l'enregistrement actif.

Voir aussi


Exemples de code