日期:2012-06-20  浏览次数:20896 次

EndOfRecordset (RecordsetEvent) 方法


如果试图移动到超过 Recordset 结尾的行时,将调用 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 以访问新检索到的记录。