EndOfRecordset-Ereignis (ADO)

  • Artikel

Das EndOfRecordset-Ereignis wird aufgerufen, wenn versucht wird, zu einer Zeile nach dem Ende des Recordset zu wechseln.

Syntax

  
EndOfRecordset fMoreData, adStatus, pRecordset

Parameter

fMoreData
Ein VARIANT_BOOL-Wert, der, wenn er auf VARIANT_TRUE festgelegt ist, angibt, dass dem Recordset weitere Zeilen hinzugefügt wurden.

adStatus
Ein EventStatusEnum-Statuswert.

Wenn EndOfRecordset aufgerufen wird, wird dieser Parameter auf adStatusOK festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war. Es wird auf adStatusCantDeny festgelegt, wenn dieses Ereignis keinen Abbruch des Vorgangs anfordern kann, der das Ereignis ausgelöst hat.

Bevor EndOfRecordset zurückgegeben wird, setzen Sie den Parameter auf adStatusUnwantedEvent, um weitere Benachrichtigungen zu verhindern.

pRecordset
Ein Recordset-Objekt. Das Recordset, für das dieses Ereignis aufgetreten ist.

Bemerkungen

Ein EndOfRecordset-Ereignis kann auftreten, wenn der MoveNext-Vorgang fehlschlägt.

Dieser Ereignishandler wird aufgerufen, wenn versucht wird, über das Ende des Recordset-Objekts hinaus zu wechseln, vielleicht als Ergebnis des Aufrufens von MoveNext. In diesem Fall können Sie jedoch weitere Datensätze aus einer Datenbank abrufen und an das Ende des Recordset anfügen. Legen Sie in diesem Fall fMoreData auf VARIANT_TRUE fest, und kehren Sie von EndOfRecordset zurück. Rufen Sie MoveNext anschließend erneut auf, um auf die neu abgerufenen Datensätze zuzugreifen.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
ADO-Ereignishandler – Übersicht