Data.Win.ADODB.TCustomADODataSet.OnEndOfRecordset

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property OnEndOfRecordset: TEndOfRecordsetEvent read FOnEndOfRecordset write FOnEndOfRecordset;

C++

__property TEndOfRecordsetEvent OnEndOfRecordset = {read=FOnEndOfRecordset, write=FOnEndOfRecordset};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event published
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

Beschreibung

Tritt ein, wenn der Satzzeiger hinter den letzten Datensatz des Recordset-Objekts verschoben wird.

In der Ereignisbehandlungsroutine für OnEndOfRecordset können Sie Aktionen durchführen, wenn der Satzzeiger hinter das Ende des Recordset verschoben wird. Wegen möglicher Auswirkungen auf die Eigenschaft Eof darf das Ereignis von keiner Delphi-Navigationsmethode ausgelöst werden. Es tritt nur bei internen Operationen ein, bei denen der Datensatzzeiger verschoben wird, oder beim direkten Zugriff auf das Recordset-Objekt (mit der Eigenschaft Recordset der Datenmenge).

DataSet gibt die ADO-Datenmenge an, in der das Ereignis aufgetreten ist. Die Datenmenge enthält auch das betreffende Recordset-Objekt.

Der Boolesche Parameter MoreData gibt an, ob sich hinter dem Datensatz, der vor Auftreten des Ereignisses abgerufen wurde, noch weitere nicht abgerufene Datensätze befinden.

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 OnEndOfRecordset tritt nur bei Recordset-Objekten ein und wird unabhängig von den Navigationsereignissen der Datenmenge ausgelöst.