Data.Win.ADODB.TCustomADODataSet.OnWillMove
Delphi
property OnWillMove: TRecordsetReasonEvent read FOnWillMove write FOnWillMove;
C++
__property TRecordsetReasonEvent OnWillMove = {read=FOnWillMove, write=FOnWillMove};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
Beschreibung
Wird vor dem Verschieben des Satzzeigers in einem Recordset-Objekt ausgelöst.
In der Ereignisbehandlungsroutine für OnWillMove können Sie Aktionen durchführen, bevor der Satzzeiger im Recordset verschoben wird. Das Ereignis wird durch die Methoden First, Last, Next, Prior, MoveBy, Insert, Delete, Post, Requery und Resynch sowie beim Zugriff auf ein Bookmark-Objekt ausgelöst. Der Zugriff auf ein Bookmark-Objekt kann das Ereignis ebenfalls auslösen.
DataSet gibt die ADO-Datenmenge an, in der das Ereignis aufgetreten ist. Die Datenmenge enthält auch das betreffende Recordset-Objekt.
Reason gibt an, durch welche Operation das Ereignis ausgelöst wurde. Obwohl der Typ TEventReason noch weitere Konstanten enthält, sind hier nur die folgenden Werte möglich: erRequery, erMove, erMoveFirst, erMoveNext, erMovePrevious und erMoveLast.
EventStatus (ADO-Wert EventStatusEnum) gibt an, ob die Operation, die das Ereignis ausgelöst hat, erfolgreich verlaufen ist.
Anmerkung: : Der Datensatzzeiger eines Recordset-Objekts unterscheidet sich vom Datensatzzeiger der ADO-Datenmenge. Es kann daher Fälle geben, in denen das Recordset-Objekt Navigationsereignisse auslöst, ohne dass die Datenmenge ein BeforeScroll- oder AfterScroll-Ereignis generiert. Mögliche Gründe hierfür sind Hintergrundaktualisierungen oder das Neusynchronsieren von Datensätzen nach Änderungen. Das Ereignis OnWillMove tritt nur bei Recordset-Objekten ein und wird unabhängig von den Navigationsereignissen der Datenmenge ausgelöst.