EndOfRecordset (RecordsetEvent) 方法

EndOfRecordset (RecordsetEvent) 方法

   

如果試圖移動(dòng)到超過 Recordset 結(jié)尾的行時(shí)，將調(diào)用 EndOfRecordset 方法。

語法

EndOfRecordset fMoreData, adStatus, pRecordset

參數(shù)

fMoreData   VARIANT_BOOL，在處理該事件期間有可能將新記錄追加到 pRecordset。在 EndOfRecordset 返回前添加數(shù)據(jù)，然后將該參數(shù)設(shè)置為 True 以指示 Recordset 的新結(jié)尾。

adStatus   EventStatusEnum 狀態(tài)值。

當(dāng)調(diào)用 EndOfRecordset 時(shí)，如果引發(fā)事件的操作成功，該參數(shù)設(shè)置為 adStatusOK。如果該方法無法請求取消引發(fā)該事件的操作，則設(shè)置為 adStatusCantDeny。

在 EndOfRecordset 返回前，將該參數(shù)設(shè)置為 adStatusUnwantedEvent 可避免后續(xù)的通知。

pRecordset   Recordset 對象，發(fā)生該事件所針對的 Recordset。

說明

如果 Recordset.MoveNext 操作失敗，則可能發(fā)生 EndOfRecordset 事件。

當(dāng)用戶可能因調(diào)用 MoveNext 而移過 pRecordset 末尾時(shí)，將調(diào)用該事件的處理程序。使用該方法用戶可以從數(shù)據(jù)庫中檢索到更多記錄并將其追加到 pRecordset 的結(jié)尾，在這種情況下，用戶要將 fMoreData 設(shè)置為 VARIANT_TRUE，并從 EndofRecordset 返回。在此之后用戶可以再次調(diào)用 MoveNext 以訪問新檢索到的記錄。