Metode UpdateBatch

  • Artikel

Menulis semua pembaruan batch yang tertunda ke disk.

Sintaks

  
recordset.UpdateBatch AffectRecords, PreserveStatus

Parameter

AffectRecords
Pilihan. Nilai AffectEnum yang menunjukkan berapa banyak rekaman yang akan memengaruhi metode UpdateBatch .

PertahankanStatus
Pilihan. Nilai Boolean yang menentukan apakah perubahan lokal atau tidak, seperti yang ditunjukkan oleh properti Status , harus diterapkan. Jika nilai ini diatur ke True, properti Status dari setiap rekaman tetap tidak berubah setelah pembaruan selesai.

Keterangan

Gunakan metode UpdateBatch saat memodifikasi objek Recordset dalam mode pembaruan batch untuk mengirimkan semua perubahan yang dibuat dalam objek Recordset ke database yang mendasar.

Jika objek Recordset mendukung pembaruan batch, Anda dapat menyimpan beberapa perubahan ke satu atau beberapa rekaman secara lokal hingga Anda memanggil metode UpdateBatch . Jika Anda mengedit rekaman saat ini atau menambahkan rekaman baru saat Anda memanggil metode UpdateBatch , ADO akan secara otomatis memanggil metode Perbarui untuk menyimpan perubahan yang tertunda ke rekaman saat ini sebelum mengirimkan perubahan batch ke penyedia. Anda harus menggunakan pembaruan batch dengan keyset atau kursor statis saja.

Catatan

Menentukan adAffectGroup sebagai nilai untuk parameter ini akan mengakibatkan kesalahan ketika tidak ada rekaman yang terlihat dalam Recordset saat ini (seperti filter yang tidak cocok dengan rekaman).

Jika upaya untuk mengirimkan perubahan gagal untuk setiap atau semua rekaman karena konflik dengan data yang mendasarinya (misalnya, rekaman telah dihapus oleh pengguna lain), penyedia mengembalikan peringatan ke koleksi Kesalahan dan kesalahan run-time terjadi. Gunakan properti Filter (adFilterAffectedRecords) dan properti Status untuk menemukan rekaman yang berkonflik.

Untuk membatalkan semua pembaruan batch yang tertunda, gunakan metode CancelBatch .

Jika properti dinamis Tabel Unik dan Perbarui Sinkronisasi Ulang diatur, dan Recordset adalah hasil dari menjalankan operasi JOIN pada beberapa tabel, maka eksekusi metode UpdateBatch secara implisit diikuti oleh metode Sinkronisasi Ulang , tergantung pada pengaturan properti Perbarui Sinkronisasi Ulang .

Urutan pembaruan individu dari batch dilakukan pada sumber data belum tentu sama dengan urutan di mana mereka dilakukan pada Recordset lokal. Urutan pembaruan tergantung pada penyedia. Mempertimbangkan hal ini saat mengoding pembaruan yang terkait satu sama lain, seperti batasan kunci asing pada sisipan atau pembaruan.

Berlaku Untuk

Objek Recordset (ADO)

Lihat juga

Contoh Metode UpdateBatch dan CancelBatch (VB)
Contoh Metode UpdateBatch dan CancelBatch (VC++)
Metode CancelBatch (ADO)
Metode Hapus (ADO)
Properti LockType (ADO)
Metode Pembaruan