EndOfRecordset (ConnectionEvent) 方法 (ADO)

移动行时如果超过记录集结尾,则调用 EndOfRecordset 方法。

语法

EndOfRecordset fMoreData, adStatus, pRecordset

参数

fMoreData VARIANT_BOOL,在处理该事件期间有可能将新记录追加到 pRecordset。在 EndOfRecordset 返回前添加数据,然后将该参数设置为 True 以指示 Recordset 的新结尾。

adStatus EventStatusEnum 状态值。

当调用 EndOfRecordset 时,如果引发事件的操作成功,将该参数设置为 adStatusOK。如果该方法无法请求取消引发该事件的操作,则设置为 adStatusCantDeny

EndOfRecordset 返回前,将该参数设置为 adStatusUnwantedEvent 可避免后续的通知。

pRecordset Recordset 对象,发生该事件所针对的 Recordset

说明

如果 Recordset.MoveNext 操作失败,则可能发生 EndOfRecordset 事件。

当用户可能因调用 MoveNext 而移过 pRecordset 结尾时,将调用该事件的处理程序。使用该方法用户可以从数据库中检索到更多记录并将其追加到 pRecordset 的结尾,在这种情况下,用户要将 fMoreData 设置为 VARIANT_TRUE,并从 EndofRecordset 返回。在此之后用户可以再次调用 MoveNext 以访问新检索到的记录。