Tutup Metode (ADO)

Artikel
05/30/2023

Menutup objek terbuka dan objek dependen apa pun.

Sintaks

  
object.Close

Keterangan

Gunakan metode Tutup untuk menutup Koneksi, Rekaman, Recordset, atau objek Stream untuk membebaskan sumber daya sistem terkait. Menutup objek tidak menghapusnya dari memori; Anda dapat mengubah pengaturan propertinya dan membukanya lagi nanti. Untuk sepenuhnya menghilangkan objek dari memori, tutup objek lalu atur variabel objek ke Tidak Ada (di Visual Basic).

Koneksi

Menggunakan metode Tutup untuk menutup objek Koneksi juga menutup objek Recordset aktif yang terkait dengan koneksi. Objek Perintah yang terkait dengan objek Koneksi yang Anda tutup akan tetap ada, tetapi tidak akan lagi dikaitkan dengan objek Koneksi ; artinya, properti ActiveConnection-nya akan diatur ke Tidak Ada. Selain itu, koleksi Parameter objek Perintah akan dihapus dari parameter yang ditentukan penyedia apa pun.

Anda nantinya dapat memanggil metode Buka untuk membuat ulang koneksi ke sumber data yang sama atau sumber data lainnya. Saat objek Koneksi ditutup, memanggil metode apa pun yang memerlukan koneksi terbuka ke sumber data menghasilkan kesalahan.

Menutup objek Koneksi saat ada objek Recordset terbuka pada koneksi mengembalikan perubahan yang tertunda di semua objek Recordset . Menutup objek Koneksi secara eksplisit (memanggil metode Tutup ) saat transaksi sedang berlangsung menghasilkan kesalahan. Jika objek Koneksi berada di luar cakupan saat transaksi sedang berlangsung, ADO secara otomatis mengembalikan transaksi.

Recordset, Record, Stream

Menggunakan metode Tutup untuk menutup objek Recordset, Record, atau Stream merilis data terkait dan akses eksklusif apa pun yang mungkin Anda miliki ke data melalui objek tertentu ini. Anda nantinya dapat memanggil metode Buka untuk membuka kembali objek dengan atribut yang sama, atau dimodifikasi.

Saat objek Recordset ditutup, memanggil metode apa pun yang memerlukan kursor langsung menghasilkan kesalahan.

Jika pengeditan sedang berlangsung saat dalam mode pembaruan langsung, memanggil metode Tutup akan menghasilkan kesalahan; sebagai gantinya, panggil metode Update atau CancelUpdate terlebih dahulu. Jika Anda menutup objek Recordset saat dalam mode pembaruan batch, semua perubahan sejak panggilan UpdateBatch terakhir hilang.

Jika Anda menggunakan metode Kloning untuk membuat salinan objek Recordset terbuka, menutup asli atau kloning tidak memengaruhi salinan lainnya.