<Complete Reference Connection Object
Sebuah acara adalah subroutine yang bisa disebut secara otomatis setelah operasi tertentu telah terjadi.
- The WillExecute acara dapat dipecat sebelum panggilan untuk objcomm.Execute, objconn.Execute, atau objrs.Open.
- The ExecuteComplete acara dapat dipecat setelah panggilan ke objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery, atau objrs.NextRecordset selesai.
Sintaksis
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Parameter | Deskripsi |
|---|---|
| src | Sebuah string yang berisi perintah SQL atau nama prosedur yang tersimpan |
| cursortyp | Menentukan jenis kursor yang akan digunakan. Salah satu CursorTypeEnum nilai-nilai |
| locktyp | Menentukan jenis kunci yang akan digunakan. Salah satu LockTypeEnum nilai-nilai |
| options | Satu atau lebih dari CommandTypeEnum atau ExecuteOptionEnum nilai-nilai |
| recaffected | Jumlah record dipengaruhi oleh eksekusi |
| objerror | Sebuah objek Kesalahan yang berisi kesalahan yang terjadi Note: Nilai EventStatusEnum harus diatur ke adStatusErrorsOccurred untuk membuat objek Kesalahan |
| status | Sebuah EventStatusEnum nilai |
| objcomm | Untuk WillExecute : Set ke objek Command yang dieksekusi atau Tidak Untuk ExecuteComplete : The Command objek yang dieksekusi |
| objrs | Untuk WillExecute : Set ke objek Recordset yang dihasilkan dari eksekusi perintah atau Tidak Untuk ExecuteComplete : The Recordset objek yang merupakan hasil dari perintah dieksekusi |
| objconn | Connection objek yang terkait dengan pelaksanaan perintah |
Nilai CursorTypeEnum
Menentukan jenis kursor yang digunakan dalam sebuah objek Recordset.
| Konstan | Nilai | Deskripsi |
|---|---|---|
| adOpenUnspecified | -1 | Tidak menentukan jenis kursor. |
| adOpenForwardOnly | 0 | Default. Menggunakan kursor forward-only. Identik dengan kursor statis, kecuali bahwa Anda hanya dapat menggulir maju melalui catatan. Hal ini meningkatkan kinerja ketika Anda perlu membuat hanya satu lulus melalui Recordset. |
| adOpenKeyset | 1 | Menggunakan kursor keyset. Seperti kursor dinamis, kecuali bahwa Anda tidak dapat melihat catatan bahwa pengguna lain menambahkan, meskipun catatan bahwa pengguna lain menghapus tidak dapat diakses dari Recordset Anda. Data perubahan oleh pengguna lain masih terlihat. |
| adOpenDynamic | 2 | Menggunakan kursor dinamis. Penambahan, perubahan, dan penghapusan oleh pengguna lain yang terlihat, dan segala jenis gerakan melalui Recordset diperbolehkan, kecuali untuk bookmark, jika provider tidak mendukung mereka. |
| adOpenStatic | 3 | Menggunakan kursor statis. Salinan statis satu set catatan yang dapat Anda gunakan untuk menemukan data atau menghasilkan laporan. Penambahan, perubahan, atau penghapusan oleh pengguna lain tidak terlihat. |
Nilai LockTypeEnum
| Konstan | Nilai | Deskripsi |
|---|---|---|
| adLockUnspecified | -1 | Tidak menentukan jenis kunci. Untuk klon, clone yang dibuat dengan jenis kunci yang sama seperti aslinya. |
| adLockReadOnly | 1 | Menunjukkan hanya-baca catatan. Anda tidak dapat mengubah data. |
| adLockPessimistic | 2 | Menunjukkan penguncian pesimis, catatan dengan catatan. penyedia melakukan apa yang diperlukan untuk memastikan editing sukses dari catatan, biasanya dengan mengunci catatan pada sumber data segera setelah editing. |
| adLockOptimistic | 3 | Menunjukkan penguncian optimis, catatan dengan catatan. penyedia menggunakan penguncian optimis, mengunci catatan hanya ketika Anda memanggil metode Update. |
| adLockBatchOptimistic | 4 | Menunjukkan update batch optimis. Diperlukan untuk modus batch update. |
Nilai CommandTypeEnum
| Konstan | Nilai | Deskripsi |
|---|---|---|
| adCmdUnspecified | -1 | Tidak menentukan jenis argumen perintah. |
| adCmdText | 1 | Mengevaluasi CommandText sebagai definisi tekstual perintah atau disimpan panggilan prosedur. |
| adCmdTable | 2 | Mengevaluasi CommandText sebagai nama tabel yang kolom semua dikembalikan oleh query SQL yang dihasilkan secara internal. |
| adCmdStoredProc | 4 | Mengevaluasi CommandText sebagai nama prosedur yang tersimpan. |
| adCmdUnknown | 8 | Menunjukkan bahwa jenis perintah dalam properti CommandText tidak diketahui. |
| adCmdFile | 256 | Mengevaluasi CommandText sebagai nama file dari Recordset terus-menerus disimpan. Digunakan dengan Recordset.Open atau Requery saja. |
| adCmdTableDirect | 512 | Mengevaluasi CommandText sebagai nama tabel yang kolom semua dikembalikan. Digunakan dengan Recordset.Open atau Requery saja. Untuk menggunakan metode Carilah, Recordset harus dibuka dengan adCmdTableDirect. Nilai ini tidak bisa digabungkan dengan nilai ExecuteOptionEnum adAsyncExecute. |
Nilai ExecuteOptionEnum
| Konstan | Nilai | Deskripsi |
|---|---|---|
| adOptionUnspecified | -1 | Menunjukkan bahwa perintah yang tidak ditentukan. |
| adAsyncExecute | 16 | Menunjukkan bahwa perintah harus mengeksekusi asynchronous. Nilai ini tidak bisa digabungkan dengan CommandTypeEnum nilai adCmdTableDirect. |
| adAsyncFetch | 32 | Menunjukkan bahwa baris yang tersisa setelah kuantitas awal ditetapkan dalam properti CacheSize harus diambil asynchronous. |
| adAsyncFetchNonBlocking | 64 | Menunjukkan bahwa thread utama tidak pernah blok saat mengambil. Jika baris yang diminta belum diambil, baris saat ini secara otomatis bergerak ke akhir file. Jika Anda membuka Recordset dari Streaming mengandung Recordset terus-menerus disimpan, adAsyncFetchNonBlocking tidak akan memiliki efek; operasi akan sinkron dan memblokir. adAsynchFetchNonBlocking tidak berpengaruh ketika opsi adCmdTableDirect digunakan untuk membuka Recordset. |
| adExecuteNoRecords | 128 | Menunjukkan bahwa teks perintah adalah perintah atau disimpan prosedur yang tidak kembali baris (for example, a command that only inserts data) . Jika ada baris yang diambil, mereka dibuang dan tidak kembali. adExecuteNoRecords hanya dapat dilewatkan sebagai parameter opsional untuk Komando atau Connection metode Execute. |
| adExecuteStream | 256 | Menunjukkan bahwa hasil dari perintah eksekusi harus dikembalikan sebagai sungai. adExecuteStream hanya dapat dilewatkan sebagai parameter opsional untuk Komando metode Execute. |
| adExecuteRecord | 512 | Menunjukkan bahwa CommandText adalah perintah atau prosedur yang tersimpan yang mengembalikan satu baris yang harus dikembalikan sebagai Rekam objek. |
Nilai EventStatusEnum
| Konstan | Nilai | Deskripsi |
|---|---|---|
| adStatusOK | 1 | Operasi yang dipecat acara ini sukses |
| adStatusErrorsOccurred | 2 | Operasi yang memicu event gagal |
| adStatusCantDeny | 3 | tidak dapat membatalkan operasi tertunda |
| adStatusCancel | 4 | Membatalkan operasi yang memicu event |
| adStatusUnwantedEvent | 5 | Mencegah pemberitahuan selanjutnya sebelum metode acara telah selesai mengeksekusi |
<Complete Reference Connection Object