Peristiwa WillExecute dan ExecuteComplete ADO
Definisi dan Penggunaan
Peristiwa adalah subrutin yang dijalankan otomatis setelah operasi khusus terjadi.
- Peristiwa WillExecute akan diaktifkan sebelum pemanggilan objcomm.Execute, objconn.Execute, atau objrs.Open.
- Peristiwa ExecuteComplete akan diaktifkan setelah pemanggilan objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery, atau objrs.NextRecordset selesai.
Sintaks
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete recaffected,objerror,status,objcomm,objrs,objconn
| parameter | Deskripsi |
|---|---|
| src | string, berisi perintah SQL atau nama prosedur yang disimpan. |
| cursortyp | menentukan jenis kursor yang akan digunakan.CursorTypeEnum nilai salah satunya. |
| locktyp | menentukan jenis kunci yang akan digunakan.LockTypeEnum nilai salah satunya. |
| options | satu atau beberapa CommandTypeEnum atau ExecuteOptionEnum Nilai |
| recaffected | Nilai Panjang, jumlah catatan yang dipengaruhi perintah ini. |
| objerror |
Objek Error yang mengandung kesalahan yang terjadi.
Keterangan: Nilai EventStatusEnum harus diatur ke adStatusErrorsOccurred, untuk membuat Objek Error ini. |
| status | satu EventStatusEnum nilai. |
| objcomm |
Untuk WillExecute: Jika peristiwa ini diatur oleh Command.Execute, parameter objcomm akan merujuk ke Objek Command, parameter objrs akan diatur ke Nothing. Untuk ExecuteComplete: Objek Command yang dieksekusi. |
| objrs |
Untuk WillExecute: Jika peristiwa ini diakibatkan oleh Recordset.Open, parameter objrs akan merujuk ke Objek Recordset, parameter pCommand akan diatur ke Nothing. Untuk ExecuteComplete: Objek Recordset, adalah hasil eksekusi perintah. |
| objconn | Objek Koneksi yang berhubungan dengan eksekusi perintah. |
Nilai EventStatusEnum
| Konstanta | Nilai | Deskripsi |
|---|---|---|
| adStatusOK | 1 | Operasi yang menyebabkan peristiwa sukses. |
| adStatusErrorsOccurred | 2 | Operasi yang menyebabkan peristiwa gagal. |
| adStatusCantDeny | 3 | Operasi yang dihentikan tidak dapat dibatalkan. |
| adStatusCancel | 4 | Batalkan operasi yang menyebabkan peristiwa. |
| adStatusUnwantedEvent | 5 | Larang pemberitahuan berikutnya sebelum penyelesaian metode peristiwa. |
