Bagikan melalui

Peristiwa WillChangeRecord dan RecordChangeComplete (ADO)

  • Artikel

Peristiwa WillChangeRecord dipanggil sebelum satu atau beberapa rekaman (baris) dalam perubahan Recordset . Peristiwa RecordChangeComplete dipanggil setelah satu atau beberapa rekaman berubah.

Sintaks

  
WillChangeRecord adReason, cRecords, adStatus, pRecordset  
RecordChangeCompleteadReason, cRecords, pError, adStatus, pRecordset

Parameter

adReason
Nilai EventReasonEnum yang menentukan alasan kejadian ini. Nilainya dapat berupa adRsnAddNew, adRsnDelete, adRsnUpdate, adRsnUndoUpdate, adRsnUndoAddNew, adRsnUndoDelete, atau adRsnFirstChange.

cRecords
Nilai Panjang yang menunjukkan jumlah rekaman yang berubah (terpengaruh).

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

adStatus
Nilai status EventStatusEnum .

Ketika WillChangeRecord 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 RecordChangeComplete dipanggil, parameter ini diatur ke adStatusOK jika operasi yang menyebabkan peristiwa berhasil, atau ke adStatusErrorsOccurred jika operasi gagal.

Sebelum WillChangeRecord kembali, atur parameter ini ke adStatusCancel untuk meminta pembatalan operasi yang menyebabkan peristiwa ini atau atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

Sebelum RecordChangeComplete kembali, atur parameter ini ke adStatusUnwantedEvent untuk mencegah pemberitahuan berikutnya.

pRecordset
Objek Recordset . Recordset tempat peristiwa ini terjadi.

Keterangan

Peristiwa WillChangeRecord atau RecordChangeComplete dapat terjadi untuk bidang pertama yang diubah secara berturut-turut karena operasi Recordset berikut: Memperbarui, Menghapus, MembatalkanUpdate, AddNew, UpdateBatch, dan CancelBatch. Nilai Recordset CursorType menentukan operasi mana yang menyebabkan peristiwa terjadi.

Selama peristiwa WillChangeRecord, properti Filter Kumpulan Rekaman diatur ke adFilterAffectedRecords. Anda tidak dapat mengubah properti ini saat memproses kejadian.

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