Hapus Metode (ADO Recordset)

Menghapus rekaman saat ini atau sekelompok rekaman.

Sintaksis

  
recordset.Delete AffectRecords  

Parameter

AffectRecords
Nilai AffectEnum yang menentukan berapa banyak rekaman yang akan memengaruhi metode Penghapusan. Nilai defaultnya adalah adAffectCurrent.

Nota

adAffectAll dan adAffectAllChapters bukan argumen yang valid untuk Hapus.

Komentar

Menggunakan metode Hapus menandai rekaman saat ini atau sekelompok rekaman dalam objek Recordset untuk dihapus. Jika objek Recordset tidak memungkinkan penghapusan rekaman, kesalahan terjadi. Jika Anda berada dalam mode pembaruan segera, penghapusan segera terjadi dalam database. Jika rekaman tidak dapat berhasil dihapus (karena pelanggaran integritas database, misalnya), rekaman akan tetap dalam mode edit setelah panggilan ke Perbarui. Ini berarti Anda harus membatalkan pembaruan dengan CancelUpdate sebelum memindahkan rekaman saat ini (misalnya, dengan Tutup, Pindahkan, atau NextRecordset).

Jika Anda berada dalam mode pembaruan batch, rekaman ditandai untuk dihapus dari cache dan penghapusan aktual terjadi saat Anda memanggil metode UpdateBatch. Gunakan properti Filter untuk melihat rekaman yang dihapus.

Mengambil nilai bidang dari rekaman yang dihapus menghasilkan kesalahan. Setelah menghapus rekaman saat ini, rekaman yang dihapus tetap terkini hingga Anda berpindah ke rekaman lain. Setelah Anda menjauh dari rekaman yang dihapus, rekaman tersebut tidak lagi dapat diakses.

Jika Anda menumpuk penghapusan dalam transaksi, Anda dapat memulihkan rekaman yang dihapus dengan metode RollbackTrans. Jika Anda berada dalam mode pembaruan batch, Anda dapat membatalkan penghapusan yang tertunda atau grup penghapusan yang tertunda dengan metode CancelBatch.

Jika upaya untuk menghapus rekaman gagal karena konflik dengan data yang mendasar (misalnya, rekaman telah dihapus oleh pengguna lain), penyedia mengembalikan peringatan ke Kesalahan koleksi tetapi tidak menghentikan eksekusi program. Kesalahan run-time hanya terjadi jika ada konflik pada semua rekaman yang diminta.

Jika properti dinamis Unique Table diatur, dan Recordset adalah hasil dari menjalankan operasi JOIN pada beberapa tabel, maka metode Hapus hanya akan menghapus baris dari tabel bernama di properti Tabel Unik.

Berlaku Untuk

Recordset Object (ADO)

Lihat Juga

Contoh Metode Penghapusan (VB)
Contoh Metode Penghapusan (VBScript)
Hapus Contoh Metode (VC++)
Metode Penghapusan (Koleksi Bidang ADO)
Metode Penghapusan (Koleksi Parameter ADO)
Metode DeleteRecord (ADO)