IBX.IBCustomDataSet.TIBCustomDataSet.OnUpdateError

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnUpdateError: TIBUpdateErrorEvent read FOnUpdateError

C++

__property TIBUpdateErrorEvent OnUpdateError = {read=FOnUpdateError, write=FOnUpdateError};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event published
IBX.IBCustomDataSet.pas
IBX.IBCustomDataSet.hpp
IBX.IBCustomDataSet TIBCustomDataSet

Beschreibung

Wird ausgelöst, wenn beim Eintragen von zwischengespeicherten Aktualisierungen in eine Datenbank eine Exception auftritt.

In einer Ereignisbehandlungsroutine für OnUpdateError können Sie auf Exceptions reagieren, die beim Eintragen von zwischengespeicherten Aktualisierungen in die Datenbank ausgelöst werden.

Da die Zwischenspeicherung eines Datensatzes und das Eintragen nacheinander erfolgen, kann der betreffende Datensatz in einer anderen Anwendung geändert werden, bevor die zwischengespeicherten Änderungen eingetragen wurden. DataSet ist der Name der Datenmenge, in die Aktualisierungen eingetragen werden.

Sie können in der Ereignisbehandlungsroutine die Eigenschaften OldValue und NewValue von TField verwenden, um die Fehlerbedinungen auszuwerten, und anschließend NewValue einen neuen Wert zum Eintragen zuweisen. In diesem Fall muss UpdateAction vor Beendigung der Routine auf uaRetry gesetzt werden.

Anmerkung:  Wenn nach einem Aufruf von ApplyUpdates, der nicht Bestandteil eines try..except-Blocks (Delphi) oder try..catch-Blocks (C++) ist, eine Exception ausgelöst wird, wird eine Fehlermeldung zurückgegeben. Falls die OnUpdateError-Ereignisbehandlungsroutine den Fehler nicht beheben kann und UpdateAction weiterhin den Wert uaFail aufweist, wird die Fehlermeldung zweimal zurückgegeben. Um dies zu verhindern, müssen Sie UpdateAction in der Ereignisbehandlungsroutine den Wert uaAbort zuweisen.

Warnung:  Wichtig: In der Ereignisbehandlungsroutine für OnUpdateError darf keine Methode aufgerufen werden, die den aktuellen Datensatz wechselt.