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 以访问新检索到的记录。