Objek Perintah (ADO)

Menentukan perintah tertentu yang ingin Anda jalankan terhadap sumber data.

Keterangan

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 koleksi Perintah , 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 struktur perintah atau 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 Dialect .

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

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

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

  • 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 penyedia akan menunggu perintah dijalankan 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 koleksi Properti .

Catatan

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-nya 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 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 mengatur properti ActiveConnection-nya ke objek Koneksi. Jika Perintah memiliki parameter, teruskan nilainya sebagai argumen ke metode .

Jika dua atau beberapa objek Perintah dijalankan pada koneksi yang sama dan salah satu 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.

Lihat juga

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