Data.DB.TField.NewValue

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property NewValue: Variant read GetNewValue write SetNewValue;

C++

__property System::Variant NewValue = {read=GetNewValue, write=SetNewValue};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
Data.DB.pas
Data.DB.hpp
Data.DB TField

Beschreibung

Repräsentiert den aktuellen Wert der Feldkomponente einschließlich der anstehenden zwischengespeicherten Aktualisierungen.

Mit NewValue können Sie den aktuellen Wert eines Feldes ermitteln oder ändern, während mehrere Aktualisierungen eingetragen werden. Wenn durch den aktuellen Feldwert beim Eintragen der Aktualisierungen ein Problem (z.B. ein Indexfehler) verursacht wird, erzeugen Datenmengen das Ereignis OnUpdateError. Entsprechend generieren Provider-Komponenten das Ereignis OnUpdateError, wenn beim Eintragen der Datensätze von einem Client Probleme auftreten. Die Client-Datenmengen erzeugen das Ereignis OnReconcileError, wenn sie durch den Provider von Problemen benachrichtigt werden. Weisen Sie zur Korrektur des Problems in der Ereignisbehandlungsroutine NewValue einen neuen Wert zu.

Die Werte von NewValue und Value sind identisch, wenn während des Eintragens von Datensätzen keine Fehler auftreten. Wird NewValue in einer OnUpdateError-, OnUpdateRecord- oder OnReconcileError-Ereignisbehandlungsroutine zugewiesen, unterscheiden sich die Werte NewValue und Value, bis die Datensätze vollständig in der zugrunde liegenden Datenbanktabelle eingetragen sind.

Anmerkung:  Die Eigenschaft NewValue kann nur verwendet werden, wenn mit der Komponente TClientDataSet auf die Daten zugegriffen wird oder zwischengespeicherte Aktualisierungen genutzt werden.

Siehe auch