Objek Perintah (ADO)

Menentukan perintah tertentu yang ingin Anda jalankan terhadap sumber data.

Komentar

Gunakan objek Perintah untuk mengkueri database dan mengembalikan rekaman dalam objek Recordset, untuk menjalankan operasi massal, atau untuk memanipulasi struktur database. Bergantung pada fungsionalitas penyedia, beberapa Perintah koleksi, metode, atau properti dapat menghasilkan kesalahan saat dirujuk.

Dengan koleksi, metode, dan properti objek Perintah, Anda dapat melakukan hal berikut:

• Tentukan teks perintah yang dapat dieksekusi (misalnya, pernyataan SQL) dengan properti CommandText. Atau, untuk perintah atau struktur kueri selain string sederhana (misalnya, kueri templat XML) tentukan perintah dengan properti CommandStream.

• Secara opsional, tunjukkan dialek perintah yang digunakan dalam CommandText atau CommandStream dengan properti Dialek.

• Tentukan kueri berparameter atau argumen prosedur tersimpan dengan parameter objek dan parameter koleksi.

• Tunjukkan apakah nama parameter harus diteruskan ke penyedia dengan properti NamedParameters.

• Jalankan perintah dan kembalikan objek Recordset jika sesuai dengan metode Execute.

• Tentukan jenis perintah dengan properti CommandType sebelum eksekusi untuk mengoptimalkan performa.

• Kontrol apakah penyedia menyimpan versi perintah yang disiapkan (atau dikompilasi) sebelum eksekusi dengan properti Disiapkan.

• Atur jumlah detik yang akan dieksekusi oleh penyedia perintah dengan properti CommandTimeout.

• Kaitkan koneksi terbuka dengan objek Perintah dengan mengatur properti ActiveConnection-nya.

• Atur properti Nama untuk mengidentifikasi objek Perintah sebagai metode pada objek Koneksi terkait.

• Teruskan objek Perintah ke properti Sumber dari Recordset untuk mendapatkan data.

• Akses atribut khusus penyedia dengan kumpulan Properti.

Nota

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

Untuk membuat objek Perintah secara independen dari objek Koneksi yang ditentukan sebelumnya, atur properti ActiveConnection ke string koneksi yang valid. ADO masih membuat objek Koneksi, tetapi tidak menetapkan objek tersebut ke variabel objek. Namun, jika Anda mengaitkan beberapa objek Perintah dengan koneksi yang sama, Anda harus secara eksplisit membuat dan membuka objek Koneksi; ini menetapkan objek Koneksi ke variabel objek. Pastikan objek Koneksi berhasil dibuka sebelum Anda menetapkannya ke properti ActiveConnection dari objek Perintah, karena menetapkan objek Koneksi tertutup menyebabkan kesalahan. Jika Anda tidak mengatur properti ActiveConnection dari objek Perintah ke variabel objek ini, ADO membuat objek Koneksi baru untuk setiap objek Perintah, bahkan jika Anda menggunakan string koneksi yang sama.

Untuk menjalankan Perintah, panggil dengan properti Nama pada objek Koneksi terkait. Perintah harus memiliki properti ActiveConnection yang diatur ke objek Koneksi. Jika Perintah memiliki parameter, teruskan nilainya sebagai argumen ke metode .

Jika dua atau lebih objek Command dijalankan pada koneksi yang sama dan objek Perintah adalah prosedur tersimpan dengan parameter output, kesalahan terjadi. Untuk menjalankan setiap objek Perintah, gunakan koneksi terpisah atau putuskan sambungan semua objek Perintah lainnya dari koneksi.

Koleksi Parameter adalah anggota default objek Perintah. Akibatnya, dua pernyataan kode berikut setara.

objCmd.Parameters.Item(0)  
objCmd(0)  

• Objek Perintah tidak aman untuk pembuatan skrip.

Bagian ini berisi topik berikut.

• Properti Objek Perintah, Metode, dan Peristiwa

Lihat Juga

Objek Koneksi (ADO)
Koleksi Parameter (ADO)
Kumpulan Properti (ADO)
Lampiran A: Penyedia