Metode CancelBatch (ADO)

Membatalkan pembaruan batch yang tertunda.

Sintaks

  
recordset.CancelBatchAffectRecords  

Parameter

AffectRecords
Opsional. Nilai AffectEnum yang menunjukkan berapa banyak rekaman yang akan terpengaruh oleh metode CancelBatch .

Keterangan

Gunakan metode CancelBatch untuk membatalkan pembaruan yang tertunda dalam Recordset dalam mode pembaruan batch. Jika Recordset berada dalam mode pembaruan langsung, memanggil CancelBatch tanpa adAffectCurrent menghasilkan kesalahan.

Jika Anda mengedit rekaman saat ini atau menambahkan rekaman baru saat Anda memanggil CancelBatch, ADO terlebih dahulu memanggil metode CancelUpdate untuk membatalkan perubahan yang di-cache. Setelah itu, semua perubahan yang tertunda dalam Recordset dibatalkan.

Rekaman saat ini mungkin tidak dapat ditentukan setelah panggilan CancelBatch , terutama jika Anda sedang dalam proses menambahkan rekaman baru. Untuk alasan ini, sangat bijaksana untuk mengatur posisi rekaman saat ini ke lokasi yang diketahui di Recordset setelah panggilan CancelBatch . Misalnya, panggil metode MoveFirst .

Jika upaya untuk membatalkan pembaruan yang tertunda gagal karena konflik dengan data yang mendasar (misalnya, jika rekaman telah dihapus oleh pengguna lain), penyedia mengembalikan peringatan ke koleksi Kesalahan tetapi tidak menghentikan eksekusi program. Kesalahan run-time hanya terjadi jika ada konflik pada semua rekaman yang diminta. Gunakan properti Filter (adFilterAffectedRecords) dan properti Status untuk menemukan rekaman yang berkonflik.

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Contoh Metode UpdateBatch dan CancelBatch (VB)
Contoh Metode UpdateBatch dan CancelBatch (VC++)
Metode Batalkan (ADO)
Metode Pembatalan (RDS)
Metode CancelUpdate (ADO)
Metode CancelUpdate (RDS)
Metode Hapus (ADO)
Properti LockType (ADO)
Metode UpdateBatch