Data.Win.ADODB.TCustomADODataSet.OnMoveComplete
Delphi
property OnMoveComplete: TRecordsetErrorEvent read FOnMoveComplete write FOnMoveComplete;
C++
__property TRecordsetErrorEvent OnMoveComplete = {read=FOnMoveComplete, write=FOnMoveComplete};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| event | published | Data.Win.ADODB.pas Data.Win.ADODB.hpp |
Data.Win.ADODB | TCustomADODataSet |
Beschreibung
Wird nach dem Verschieben des Satzzeigers in einem Recordset-Objekt ausgelöst.
In der Ereignisbehandlungsroutine OnMoveComplete können Sie Aktionen durchführen, nachdem der Satzzeiger im Recordset verschoben wurde. 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 eingetreten 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.
Error ist ein ADO-Fehlerobjekt. Informationen zu diesen Objekten finden Sie in der Hilfe zum Microsoft SDK. Der Parameter wird nur zugewiesen, wenn bei der Operation ein Fehler aufgetreten ist. In diesem Fall wird im Parameter EventStatus der Wert esErrorsOccured übergeben.
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 OnMoveComplete tritt nur bei Recordset-Objekten ein und wird unabhängig von den Navigationsereignissen der Datenmenge ausgelöst.