Metode NextRecordset (ADO)

Menghapus objek Recordset saat ini dan mengembalikan Recordset berikutnya dengan maju melalui serangkaian perintah.

Sintaksis

  
Set recordset2 = recordset1.NextRecordset(RecordsAffected )  

Mengembalikan Nilai

Mengembalikan objek Recordset. Dalam model sintaks, recordset1 dan recordset2 bisa menjadi objek Recordset yang sama, atau Anda dapat menggunakan objek terpisah. Saat menggunakan objek Recordset terpisah, mengatur ulang properti ActiveConnection pada Recordset asli (recordset1) setelah NextRecordset dipanggil akan menghasilkan kesalahan.

Parameter

RecordAffected
Fakultatif. Variabel Long tempat penyedia mengembalikan jumlah rekaman yang terpengaruh operasi saat ini.

Nota

Parameter ini hanya mengembalikan jumlah rekaman yang terpengaruh oleh operasi; ini tidak mengembalikan hitungan rekaman dari pernyataan pilih yang digunakan untuk menghasilkan Recordset.

Komentar

Gunakan metode NextRecordset untuk mengembalikan hasil perintah berikutnya dalam pernyataan perintah majemuk atau prosedur tersimpan yang mengembalikan beberapa hasil. Jika Anda membuka objek Recordset berdasarkan pernyataan perintah gabungan (misalnya, "SELECT * FROM table1; SELECT * FROM table2") menggunakan metode Execute pada Perintah atau metode Buka pada Recordset, ADO hanya menjalankan perintah pertama dan mengembalikan hasilnya ke recordset. Untuk mengakses hasil perintah berikutnya dalam pernyataan, panggil metode NextRecordset.

Selama ada hasil tambahan dan Recordset yang berisi pernyataan majemuk tidak terputus atau dirusak di seluruh batas proses, metode NextRecordset akan terus mengembalikan Recordset objek. Jika perintah pengembalian baris berhasil dijalankan tetapi tidak mengembalikan rekaman, Recordset objek yang dikembalikan akan terbuka tetapi kosong. Uji untuk kasus ini dengan memverifikasi bahwa properti BOF dan EOF keduanya True. Jika perintah yang tidak menampilkan baris berhasil dijalankan, objek Recordset yang dikembalikan akan ditutup, yang dapat Anda verifikasi dengan menguji properti Status pada Recordset . Ketika tidak ada hasil lagi, kumpulan catatan akan diatur ke Tidak Ada yang.

Metode NextRecordset tidak tersedia pada objek Recordset yang terputus, di mana ActiveConnection telah diatur ke Tidak Ada (di Microsoft Visual Basic) atau NULL (dalam bahasa lain).

Jika pengeditan sedang berlangsung saat dalam mode pembaruan langsung, memanggil metode NextRecordset menghasilkan kesalahan; hubungi metode Update atau CancelUpdate terlebih dahulu.

Untuk meneruskan parameter untuk lebih dari satu perintah dalam pernyataan gabungan dengan mengisi Parameter koleksi, atau dengan meneruskan array dengan asli Buka atau panggilan Jalankan, parameter harus dalam urutan yang sama dalam koleksi atau array sebagai perintah masing-masing dalam seri perintah. Anda harus menyelesaikan membaca semua hasil sebelum membaca nilai parameter output.

Penyedia OLE DB Anda menentukan kapan setiap perintah dalam pernyataan gabungan dijalankan. Penyedia Microsoft OLE DB untuk SQL Server, misalnya, menjalankan semua perintah dalam batch setelah menerima pernyataan majemuk. Recordsets yang dihasilkan hanya dikembalikan saat Anda memanggil NextRecordset.

Namun, penyedia lain dapat menjalankan perintah berikutnya dalam pernyataan hanya setelah NextRecordset dipanggil. Untuk penyedia ini, jika Anda secara eksplisit menutup objek Recordset sebelum menelusuri seluruh pernyataan perintah, ADO tidak pernah menjalankan perintah yang tersisa.

Berlaku Untuk

Recordset Object (ADO)

Lihat Juga

Contoh Metode NextRecordset (VB)
Contoh Metode NextRecordset (VC++)