Objek Koneksi (ADO)

Mewakili koneksi terbuka ke sumber data.

Keterangan

Objek Koneksi mewakili sesi unik dengan sumber data. Dalam sistem database klien/server, mungkin setara dengan koneksi jaringan aktual ke server. Bergantung pada fungsionalitas yang didukung oleh penyedia, beberapa koleksi, metode, atau properti objek Koneksi mungkin tidak tersedia.

Dengan koleksi, metode, dan properti objek Koneksi , Anda bisa melakukan hal berikut:

  • Konfigurasikan koneksi sebelum membukanya dengan properti ConnectionString, ConnectionTimeout, dan Mode . ConnectionString adalah properti default objek Koneksi .

  • Atur properti CursorLocation ke klien untuk memanggil Layanan Kursor Microsoft untuk OLE DB, yang mendukung pembaruan batch.

  • Atur database default untuk koneksi dengan properti DefaultDatabase .

  • Atur tingkat isolasi untuk transaksi yang dibuka pada koneksi dengan properti IsolationLevel .

  • Tentukan penyedia OLE DB dengan properti Penyedia .

  • Tetapkan, dan kemudian putus, koneksi fisik ke sumber data dengan metode Buka dan Tutup .

  • Jalankan perintah pada koneksi dengan metode Execute dan konfigurasikan eksekusi dengan properti CommandTimeout .

    Catatan

    Untuk menjalankan kueri tanpa menggunakan objek Perintah, teruskan string kueri ke metode Jalankan objek Koneksi . Namun, objek Perintah diperlukan saat Anda ingin mempertahankan teks perintah dan menjalankannya kembali, atau menggunakan parameter kueri.

  • Kelola transaksi pada koneksi terbuka, termasuk transaksi berlapis jika penyedia mendukungnya, dengan metode BeginTrans, CommitTrans, dan RollbackTrans dan properti Atribut .

  • Periksa kesalahan yang dikembalikan dari sumber data dengan kumpulan Kesalahan .

  • Baca versi dari implementasi ADO yang digunakan dengan properti Versi .

  • Dapatkan informasi skema tentang database Anda dengan metode OpenSchema .

Anda dapat membuat objek Koneksi secara independen dari objek lain yang ditentukan sebelumnya.

Anda dapat menjalankan perintah bernama atau prosedur tersimpan seolah-olah itu adalah metode asli pada objek Koneksi , seperti yang ditunjukkan di bagian berikutnya. Ketika perintah bernama memiliki nama yang sama dengan prosedur tersimpan, panggil "panggilan metode asli" pada objek Koneksi selalu jalankan perintah bernama alih-alih prosedur penyimpanan.

Catatan

Jangan gunakan fitur ini (memanggil perintah bernama atau prosedur tersimpan seolah-olah itu adalah metode asli pada objek Koneksi) dalam aplikasi Microsoft® .NET Framework, karena implementasi yang mendasar dari fitur bertentangan dengan cara .NET Framework menginteroperagasi COM.

Menjalankan perintah sebagai metode asli dari objek Koneksi

Untuk menjalankan perintah, beri nama perintah menggunakan properti Nama objek Perintah. Atur properti ActiveConnection dari objek Perintah ke koneksi. Kemudian terbitkan pernyataan di mana nama perintah digunakan seolah-olah itu adalah metode pada objek Koneksi , diikuti oleh parameter apa pun, dan objek Recordset jika ada baris yang dikembalikan. Atur properti Recordset untuk menyesuaikan Recordset yang dihasilkan. Contohnya:

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst  

Menjalankan prosedur tersimpan sebagai metode asli objek Koneksi

Untuk menjalankan prosedur tersimpan, terbitkan pernyataan di mana nama prosedur tersimpan digunakan seolah-olah itu adalah metode pada objek Koneksi , diikuti oleh parameter apa pun. ADO akan membuat "tebakan terbaik" dari jenis parameter. Contohnya:

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"  

Objek Koneksi aman untuk pembuatan skrip.

Bagian ini berisi topik berikut.

Lihat juga

Objek Perintah (ADO)
Kumpulan Kesalahan (ADO)
Kumpulan Properti (ADO)
Objek Recordset (ADO)
Lampiran A: Penyedia