Data.DB.TUpdateErrorEvent
Delphi
TUpdateErrorEvent = procedure(DataSet: TDataSet; E: EDatabaseError;
UpdateKind: TUpdateKind; var UpdateAction: TUpdateAction) of object;
C++
typedef void __fastcall (__closure *TUpdateErrorEvent)(TDataSet* DataSet, EDatabaseError* E, TUpdateKind UpdateKind, TUpdateAction &UpdateAction);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
type typedef |
public | Data.DB.pas Data.DB.hpp |
Data.DB | Data.DB |
Beschreibung
Das Ereignis TUpdateErrorEvent wird ausgelöst, wenn während einer Aktualisierung Fehler auftreten.
Die Ereignisbehandlungsroutine TUpdateErrorEvent behandelt Fehler, die während einer Aktualisierung auftreten können.
DataSet ist der Name der Datenmenge, in die Aktualisierungen eingetragen werden.
E ist ein Zeiger auf ein Objekt der Klasse EDatabaseError, dem in einer Anwendung eine Fehlermeldung und die Ursache des Fehlers entnommen werden können. Sie können anhand dieser Informationen festlegen, wie auf die Fehlerbedingung reagiert werden soll.
UpdateKind gibt an, ob der Fehler beim Einfügen, Löschen oder Ändern eines Datensatzes aufgetreten ist.
UpdateAction gibt die Aktion an, die durchgeführt werden soll, wenn die Ereignisbehandlungsroutine beendet wird. Beim Eintritt in die Routine wird UpdateAction immer auf uaFail gesetzt. Falls der Fehler in der Ereignisbehandlungsroutine verarbeitet oder korrigiert werden kann, weisen Sie vor dem Beenden der Ereignisbehandlungsroutine UpdateAction den Wert uaRetry zu.
Sie können in der Fehlerbehandlungsroutine mit den Eigenschaften OldValue und NewValue von TField Fehlerbedingungen auswerten und NewValue einen neuen Wert zum Eintragen zuweisen. In diesem Fall muss UpdateAction vor Beendigung der Routine auf uaRetry gesetzt werden.