Metode CancelBatch (ADO)
Membatalkan pembaruan batch yang tertunda.
Sintaks
recordset.CancelBatchAffectRecords
Parameter
AffectRecords
Opsional. Nilai AffectEnum yang menunjukkan berapa banyak rekaman yang akan memengaruhi 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 memanggil CancelBatch, ADO terlebih dahulu memanggil metode CancelUpdate untuk membatalkan perubahan cache apa pun. 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, 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
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