Metode UpdateBatch

Menulis semua pembaruan batch yang tertunda ke disk.

Sintaksis

  
recordset.UpdateBatch AffectRecords, PreserveStatus  

Parameter

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

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

Komentar

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 pada satu atau beberapa rekaman secara lokal hingga Anda memanggil metode UpdateBatch. Jika Anda mengedit rekaman saat ini atau menambahkan rekaman baru saat memanggil metode UpdateBatch, ADO akan secara otomatis memanggil metode Pembaruan untuk menyimpan perubahan tertunda ke rekaman saat ini sebelum mengirimkan perubahan batch ke penyedia. Anda harus menggunakan pembaruan batch dengan keyset atau kursor statis saja.

Nota

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 Kesalahan koleksi 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 Tabel Unik dan properti dinamis Sinkronisasi Ulang Pembaruan diatur, dan Recordset adalah hasil dari menjalankan operasi JOIN pada beberapa tabel, maka eksekusi metode UpdateBatch secara implisit diikuti dengan metode Resync, tergantung pada pengaturan properti Update Resync.

Urutan di mana pembaruan individual batch dilakukan pada sumber data belum tentu sama dengan urutan di mana mereka dilakukan pada Recordsetlokal. Urutan pembaruan bergantung pada penyedia. Mempertimbangkan hal ini saat mengkoding pembaruan yang terkait satu sama lain, seperti batasan kunci asing pada sisipan atau pembaruan.

Berlaku Untuk

Recordset Object (ADO)

Lihat Juga

UpdateBatch dan CancelBatch Methods Example (VB)
Contoh Metode UpdateBatch dan CancelBatch (VC++)
Metode CancelBatch (ADO)
Clear Method (ADO)
Properti LockType (ADO)
Metode Pembaruan