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.