Data.DB.TDataSet.SetFields
Delphi
procedure SetFields(const Values: array of const);
C++
void __fastcall SetFields(System::TVarRec const *Values, const int Values_Size);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Description
Affecte la valeur de tous les champs d'un enregistrement.
Appelez SetFields pour affecter simultanément une valeur à chaque champ de l'enregistrement actif.
Values contient les valeurs à placer dans chaque champ. Les valeurs sont affectées à l'enregistrement en se basant sur l'ordre des colonnes des tables sous-jacentes de l'ensemble de données. Ces valeurs peuvent être des littéraux, des variables, NULL, ou nil (Delphi). Si Values contient moins de valeurs qu'il n'y a de champs dans l'enregistrement, la valeur NULL est affectée à tous les champs pour lesquels aucune valeur n'est spécifiée. Une valeur NULL remplace toute valeur existante dans ces champs.
Dans C++, Values_Size est l'indice de la dernière valeur dans le tableau Values (un de moins que le nombre total de valeurs).
Avant d'appeler SetFields, appelez Edit pour placer l'ensemble de données dans l'état dsEdit. Après l'appel de SetFields, appelez Post pour écrire les modifications dans la base de données ou le journal des modifications.
Remarque : Pour modifier la valeur de certains champs sans changer celle d'autres champs, transmettez nil (Delphi) ou NULL (C++) (transtypage explicite en void * dans C++) pour les champs devant rester inchangés.