Data.DB.TField.OnValidate
Delphi
property OnValidate: TFieldNotifyEvent read FOnValidate write FOnValidate;
C++
__property TFieldNotifyEvent OnValidate = {read=FOnValidate, write=FOnValidate};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | published | Data.DB.pas Data.DB.hpp |
Data.DB | TField |
Beschreibung
Wird direkt vor dem Speichern der Daten im Datensatzpuffer ausgelöst.
In eine OnValidate-Ereignisbehandlungsroutine können Sie die Änderungen der Felddaten überprüfen, bevor die Daten in den Datensatzpuffer geschrieben werden. Während der Eingabe von Daten durch den Benutzer können diese mit Hilfe der Eigenschaft EditMask zeichenweise geprüft werden. Eine Anwendung kann mit OnValidate die Daten insgesamt prüfen.
Wird einer Feldkomponente programmseitig ein Wert zugewiesen, wird die Prüfung durch EditMask umgangen, da kein datensensitives Steuerelement vorhanden ist, das die Berücksichtigung der Maske erzwingt. In Anwendungen können die Daten mit Hilfe von OnValidate vor dem Eintragen in die Datenbanktabelle geprüft werden.
Um den aktuellen Feldwert zu verwerfen, sollte die Ereignisbehandlungsroutine eine Exception auslösen.
Folgende Schritte laufen ab, wenn ein Feld in den aktuellen Datensatzpuffer geschrieben wird:
1. Die Ereignisbehandlungsroutine OnValidate wird zur Prüfung der Daten aufgerufen.
2. Löst die Ereignisbehandlungsroutine OnValidate keine Exception aus, werden die Daten in den aktuellen Datensatzpuffer geschrieben.
3. Löst das Schreiben der Daten keine Exception aus, wird die Ereignisbehandlungsroutine OnChange aufgerufen. Damit kann auf die durchgeführten Änderungen reagiert werden.
OnValidate ist eine Ereignisbehandlungsroutine des Typs Data.DB.TFieldNotifyEvent.