Peristiwa WillChangeRecordset dan RecordsetChangeComplete (ADO)

Peristiwa WillChangeRecordset dipanggil sebelum operasi yang tertunda mengubah Recordset. Peristiwa RecordsetChangeComplete dipanggil setelah Recordset berubah.

Sintaks

  
WillChangeRecordset adReason, adStatus, pRecordset  
RecordsetChangeComplete adReason, pError, adStatus, pRecordset  

Parameter

adReason
Nilai EventReasonEnum yang menentukan alasan kejadian ini. Nilainya bisa adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen.

adStatus
Nilai status EventStatusEnum .

Ketika WillChangeRecordset dipanggil, parameter ini diatur ke adStatusOK jika operasi yang menyebabkan peristiwa berhasil. Ini diatur ke adStatusCantDeny jika kejadian ini tidak dapat meminta pembatalan operasi yang tertunda.

Ketika RecordsetChangeComplete dipanggil, parameter ini diatur ke adStatusOK jika operasi yang menyebabkan peristiwa berhasil, adStatusErrorsOccurred jika operasi gagal, atau adStatusCancel jika operasi yang terkait dengan peristiwa WillChangeRecordset yang diterima sebelumnya telah dibatalkan.

Sebelum WillChangeRecordset kembali, atur parameter ini ke adStatusCancel untuk meminta pembatalan operasi yang tertunda atau atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

Sebelum WillChangeRecordset atau RecordsetChangeComplete kembali, atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

pError
Objek Kesalahan . Ini menjelaskan kesalahan yang terjadi jika nilai adStatus adalah adStatusErrorsOccurred; jika tidak, itu tidak diatur.

pRecordset
Objek Recordset . Recordset tempat peristiwa ini terjadi.

Keterangan

Peristiwa WillChangeRecordset atau RecordsetChangeComplete dapat terjadi karena metode RecordsetRequery atau Open .

Jika penyedia tidak mendukung marka buku, pemberitahuan peristiwa RecordsetChange terjadi setiap kali baris baru diambil dari penyedia. Frekuensi peristiwa ini bergantung pada properti RecordsetCacheSize .

Anda harus mengatur parameter adStatus ke adStatusUnwantedEvent untuk setiap nilai adReason yang mungkin untuk sepenuhnya menghentikan pemberitahuan peristiwa untuk peristiwa apa pun yang menyertakan parameter adReason .

Lihat juga

Contoh Model Peristiwa ADO (VC++)
Ringkasan Penanganan Aktivitas ADO