Properti ActiveConnection (ADO)

Artikel
05/30/2023

Menunjukkan objek Koneksi mana yang merupakan objek Perintah, Kumpulan Rekaman, atau Rekaman yang ditentukan saat ini.

Pengaturan dan Nilai Pengembalian

Mengatur atau mengembalikan nilai String yang berisi definisi untuk koneksi jika koneksi ditutup, atau Varian yang berisi objek Koneksi saat ini jika koneksi terbuka. Defaultnya adalah referensi objek null. Lihat properti ConnectionString .

Keterangan

Gunakan properti ActiveConnection untuk menentukan objek Koneksi tempat objek Perintah yang ditentukan akan dijalankan atau Recordset yang ditentukan akan dibuka.

Perintah

Untuk objek Perintah , properti ActiveConnection adalah baca/tulis.

Jika Anda mencoba memanggil metode Jalankan pada objek Perintah sebelum mengatur properti ini ke objek Koneksi yang terbuka atau string koneksi yang valid, kesalahan terjadi.

Jika objek Koneksi ditetapkan ke properti ActiveConnection , objek harus dibuka. Menetapkan objek Koneksi tertutup menyebabkan kesalahan.

Catatan

Microsoft Visual Basic Mengatur properti ActiveConnection ke Tidak ada yang memisahkan objek Perintah dari Koneksi saat ini dan menyebabkan penyedia merilis sumber daya terkait pada sumber data. Anda kemudian dapat mengaitkan objek Perintah dengan objek Koneksi yang sama atau lainnya. Beberapa penyedia memungkinkan Anda mengubah pengaturan properti dari satu Koneksi ke Koneksi lainnya, tanpa harus terlebih dahulu mengatur properti ke Tidak ada.

Jika kumpulan Parameter objek Perintah berisi parameter yang disediakan oleh penyedia, koleksi akan dihapus jika Anda mengatur properti ActiveConnection ke Tidak Ada atau ke objek Koneksi lain. Jika Anda membuat objek Parameter secara manual dan menggunakannya untuk mengisi kumpulan Parameter objek Perintah , mengatur properti ActiveConnection ke Tidak Ada atau ke objek Koneksi lain membuat koleksi Parameter tetap utuh.

Menutup objek Koneksi tempat objek Perintah dikaitkan mengatur properti ActiveConnection ke Tidak Ada. Menyetel properti ini ke objek Koneksi tertutup menghasilkan kesalahan.

Recordset

Untuk objek Recordset terbuka atau untuk objek Recordset yang properti Sumbernya diatur ke objek Perintah yang valid, properti ActiveConnection bersifat baca-saja. Jika tidak, itu adalah baca/tulis.

Anda dapat mengatur properti ini ke objek Koneksi yang valid atau ke string koneksi yang valid. Dalam hal ini, penyedia membuat objek Koneksi baru menggunakan definisi ini dan membuka koneksi. Selain itu, penyedia dapat mengatur properti ini ke objek Koneksi baru untuk memberi Anda cara mengakses objek Koneksi untuk informasi kesalahan yang diperluas atau untuk menjalankan perintah lain.

Jika Anda menggunakan argumen ActiveConnection dari metode Buka untuk membuka objek Recordset , properti ActiveConnection akan mewarisi nilai argumen.

Jika Anda mengatur properti Sumber objek Recordset ke variabel objek Perintah yang valid, properti ActiveConnection dari Recordset mewarisi pengaturan properti ActiveConnection objek Perintah.

Catatan

Penggunaan Layanan Data Jarak Jauh Saat digunakan pada objek Recordset sisi klien, properti ini hanya dapat diatur ke string koneksi atau (di Microsoft Visual Basic atau Visual Basic, Scripting Edition) ke Tidak Ada.

Rekaman

Properti ini dibaca/ditulis ketika objek Rekaman ditutup, dan mungkin berisi string koneksi atau referensi ke objek Koneksi yang terbuka. Properti ini bersifat baca-saja ketika objek Rekaman terbuka, dan berisi referensi ke objek Koneksi yang terbuka.

Objek Koneksi dibuat secara implisit saat objek Rekaman dibuka dari URL. Buka Rekaman dengan objek Koneksi yang sudah ada, buka dengan menetapkan objek Koneksi ke properti ini, atau menggunakan objek Koneksi sebagai parameter dalam panggilan Metode terbuka . Jika Rekaman dibuka dari Rekaman atau Recordset yang sudah ada, maka secara otomatis dikaitkan dengan objek Koneksi objek Rekaman atau Recordset tersebut.