ADO事件之(2)---EndOfRecordset (RecordsetEvent) 方法

ado

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