Objek kesalahan

Berisi detail tentang kesalahan akses data yang berkaitan dengan satu operasi yang melibatkan penyedia.

Keterangan

Setiap operasi yang melibatkan objek ADO dapat menghasilkan satu atau beberapa kesalahan penyedia. Saat setiap kesalahan terjadi, satu atau beberapa objek Kesalahan ditempatkan dalam kumpulan Kesalahan objek Koneksi . Ketika operasi ADO lain menghasilkan kesalahan, kumpulan Kesalahan dibersihkan , dan kumpulan objek Kesalahan baru ditempatkan dalam koleksi Kesalahan .

Catatan

Setiap objek Kesalahan mewakili kesalahan penyedia tertentu, bukan kesalahan ADO. Kesalahan ADO diekspos ke mekanisme penanganan pengecualian run-time. Misalnya, di Microsoft Visual Basic, terjadinya kesalahan khusus ADO akan memicu peristiwa On Error dan muncul di objek Kesalahan . Untuk daftar lengkap kesalahan ADO, lihat topik ErrorValueEnum .

Anda dapat membaca properti objek Kesalahan untuk mendapatkan detail spesifik tentang setiap kesalahan, termasuk yang berikut ini:

  • Properti Deskripsi , yang berisi teks kesalahan. Ini adalah properti default.

  • Properti Angka , yang berisi nilai Bilangan bulat panjang dari konstanta kesalahan.

  • Properti Sumber , yang mengidentifikasi objek yang memunculkan kesalahan. Ini sangat berguna ketika Anda memiliki beberapa objek Kesalahan dalam kumpulan Kesalahan setelah permintaan ke sumber data.

  • Properti SQLState dan NativeError , yang menyediakan informasi dari sumber data SQL.

Ketika terjadi kesalahan penyedia, kesalahan ditempatkan dalam kumpulan Kesalahan objek Koneksi . ADO mendukung pengembalian beberapa kesalahan oleh satu operasi ADO untuk memungkinkan informasi kesalahan khusus untuk penyedia. Untuk mendapatkan informasi kesalahan yang kaya ini dalam penangan kesalahan, gunakan fitur penjebak kesalahan yang sesuai dari bahasa atau lingkungan yang sedang Anda kerjakan, lalu gunakan perulangan berlapis untuk menghitung properti setiap objek Kesalahan dalam kumpulan Kesalahan .

Catatan

Pengguna Microsoft Visual Basic dan VBScript Jika tidak ada objek Koneksi yang valid, Anda harus mengambil informasi kesalahan dari objek Kesalahan .

Sama seperti penyedia, ADO menghapus objek Info Kesalahan OLE sebelum melakukan panggilan yang berpotensi menghasilkan kesalahan penyedia baru. Namun, kumpulan Kesalahan pada objek Koneksidibersihkan dan diisi hanya ketika penyedia menghasilkan kesalahan baru, atau ketika metode Clear dipanggil.

Beberapa properti dan metode mengembalikan peringatan yang muncul sebagai objek Kesalahan dalam koleksi Kesalahan tetapi tidak menghentikan eksekusi program. Sebelum Anda memanggil metode Resync, UpdateBatch, atau CancelBatch pada objek Recordset ; metode Buka pada objek Koneksi ; atau atur properti Filter pada objek Recordset , panggil metode Hapus pada kumpulan Kesalahan . Dengan demikian, Anda dapat membaca properti Hitung dari kumpulan Kesalahan untuk menguji peringatan yang dikembalikan.

Objek Kesalahan tidak aman untuk pembuatan skrip.

Bagian ini berisi topik berikut.

Lihat juga

Deskripsi, HelpContext, HelpFile, NativeError, Number, Source, dan SQLState Properties Example (VB)
Deskripsi, HelpContext, HelpFile, NativeError, Number, Source, dan SQLState Properties Example (VC++)
Objek Koneksi (ADO)
Kumpulan Kesalahan (ADO)
Lampiran A: Penyedia