Metode NextRecordset (ADO)

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

Sintaks

  
Set recordset2 = recordset1.NextRecordset(RecordsAffected )  

Tampilkan Nilai

Mengembalikan objek Recordset . Dalam model sintaks, recordset1 dan recordset2 dapat 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

RecordsAffected
Pilihan. Variabel Panjang tempat penyedia mengembalikan jumlah rekaman yang terpengaruh operasi saat ini.

Catatan

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

Keterangan

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 Open 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 objek Recordset . Jika perintah pengembalian baris berhasil dijalankan tetapi tidak mengembalikan rekaman, objek Recordset yang dikembalikan akan terbuka tetapi kosong. Uji untuk kasus ini dengan memverifikasi bahwa properti BOF dan EOF keduanya True. Jika perintah non-row-returning berhasil dijalankan, objek Recordset yang dikembalikan akan ditutup, yang dapat Anda verifikasi dengan menguji properti Status pada Recordset. Ketika tidak ada hasil lagi, recordset akan diatur ke Tidak Ada.

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 akan menghasilkan kesalahan; panggil metode Update atau CancelUpdate terlebih dahulu.

Untuk meneruskan parameter untuk lebih dari satu perintah dalam pernyataan campuran dengan mengisi koleksi Parameter , atau dengan meneruskan array dengan panggilan Buka atau Jalankan asli, parameter harus dalam urutan yang sama dalam koleksi atau array sebagai perintah masing-masing dalam seri perintah. Anda harus selesai 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 gabungan. Recordset 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

Objek Recordset (ADO)

Lihat juga

Contoh Metode NextRecordset (Visual Basic)
Contoh Metode NextRecordset (VC++)