清除當(dāng)前 Recordset 對象并通過提前執(zhí)行命令序列返回下一個記錄集。
語法
Set recordset2 = recordset1.NextRecordset( RecordsAffected )
返回值
返回 Recordset 對象。在語法模型中，recordset1 和 recordset2 可以是相同的 Recordset 對象，或者可以使用不同的對象。
參數(shù)
RecordsAffected 可選，長整型變量，提供者向其返回當(dāng)前操作所影響的記錄數(shù)目。
注意 該參數(shù)僅返回受操作影響的記錄的數(shù)目；它不會從用于生成 Recordset 的選擇語句返回記錄的計數(shù)。
說明
使用 NextRecordset 方法返回復(fù)合命令語句中下一條命令的結(jié)果，或者是返回多個結(jié)果的已存儲過程結(jié)果。如果使用 Command 的 Execute 方法或者 Recordset 的 Open 方法打開基于復(fù)合命令語句（例如“SELECT * FROM table1;SELECT * FROM table2”）的 Recordset 對象，則 ADO 僅執(zhí)行第一條命令并將結(jié)果返回到“記錄集”。要訪問語句中后續(xù)命令的結(jié)果，請調(diào)用 NextRecordset 方法。
只要有其他的結(jié)果，并且包含復(fù)合語句的 Recordset 未被跨進程邊界調(diào)度，則 NextRecordset 方法將繼續(xù)返回 Recordset 對象。如果行返回命令沒有返回記錄，則返回的 Recordset 對象將為空；在確認 BOF 和 EOF 都為 True 的情況下可驗證這種情況。如果非按行返回命令成功執(zhí)行，則返回的 Recordset 對象將關(guān)閉，通過測試 Recordset 的 State 屬性可以測試這種情況。如果沒有其他的結(jié)果，“記錄集”將設(shè)置為 Nothing。
遠程數(shù)據(jù)服務(wù)用法 NextRecordset 方法對客戶端的 Recordset 對象不可用。
如果在立即更新模式下進行編輯，調(diào)用 NextRecordset 方法將產(chǎn)生錯誤。應(yīng)首先調(diào)用 Update 或 CancelUpdate 方法。
如果需要通過填寫 Parameters 集合或者通過使用原有的 Open 或 Execute 調(diào)用傳送數(shù)組為復(fù)合語句中的多個命令傳送參數(shù)，則參數(shù)在集合或數(shù)組中的次序必須與它們在命令序列中各自命令的次序相同。在讀取輸出參數(shù)值之前必須讀取所有結(jié)果。
在調(diào)用 NextRecordset 方法時，ADO 僅執(zhí)行語句中的下一條命令。如果在單步執(zhí)行整個命令語句之前顯式關(guān)閉 Recordset 對象，則 ADO 不執(zhí)行其余的命令。