Data.DB.TDataSet.SetFields

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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++).

Siehe auch