Data.DB.TDataSet.SetFields
Delphi
procedure SetFields(const Values: array of const);
C++
void __fastcall SetFields(const System::TVarRec *Values, const int Values_High);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Beschreibung
Weist allen Feldern eines Datensatzes Werte zu.
Mit SetFields können Sie einigen oder allen Feldern des aktiven Datensatzes in einer Operation Werte zuweisen.
Values enthält die Werte, die den einzelnen Feldern zugewiesen werden sollen. Die Zuweisung erfolgt in der Reihenfolge der Spalten in der zugrunde liegenden Tabelle. Als Werte können Literale, Variablen sowie NULL oder nil (Delphi) angegeben werden. Enthält der Parameter Values weniger Werte als Felder im Datensatz vorhanden sind, werden die verbleibenden Felder auf NULL gesetzt. Dabei werden die vorhandenen Feldwerte überschrieben.
Values_Size ist in C++ der Index des letzen Wertes im Array Values (eins kleiner als die Gesamtzahl der Werte).
Rufen Sie vor SetFields die Methode Edit auf, um den Modus der Datenmenge in dsEdit zu ändern. Tragen Sie nach dem Aufruf von SetFields die Änderungen mit der Methode Post in die Datenbank oder das Änderungsprotokoll ein.
Hinweis: Um nur einigen Feldern einen Wert zuzuweisen und die vorhandenen Werte der anderen Felder zu erhalten, übergeben Sie für jedes nicht zu ändernde Feld den Wert nil (Delphi) bzw. NULL (C++) (explizite Typumwandlung zu void * in C++).