Metode Hapus (ADO Recordset)

Menghapus rekaman saat ini atau sekelompok rekaman.

Sintaks

  
recordset.Delete AffectRecords  

Parameter

AffectRecords
Nilai AffectEnum yang menentukan berapa banyak rekaman yang akan dipengaruhi oleh metode Hapus . Nilai defaultnya adalah adAffectCurrent.

Catatan

adAffectAll dan adAffectAllChapters bukan argumen yang valid untuk Dihapus.

Keterangan

Menggunakan metode Hapus menandai rekaman saat ini atau grup rekaman dalam objek Recordset untuk dihapus. Jika objek Recordset tidak mengizinkan penghapusan rekaman, kesalahan terjadi. Jika Anda berada dalam mode pembaruan segera, penghapusan terjadi dalam database segera. Jika rekaman tidak 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 menampilkan 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 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 koleksi Kesalahan tetapi tidak menghentikan eksekusi program. Kesalahan run-time hanya terjadi jika ada konflik pada semua rekaman yang diminta.

Jika properti dinamis Tabel Unik 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

Objek Recordset (ADO)

Lihat juga

Contoh Metode Hapus (Visual Basic)
Contoh Metode Hapus (VBScript)
Contoh Metode Hapus (VC++)
Metode Hapus (Kumpulan Bidang ADO)
Metode Hapus (Koleksi Parameter ADO)
Metode DeleteRecord (ADO)