Metode Eksekusi (Perintah ADO)

Menjalankan kueri, pernyataan SQL, atau prosedur tersimpan yang ditentukan dalam properti CommandText atau CommandStream dari objek Perintah.

Sintaks

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Tampilkan Nilai

Mengembalikan referensi objek Recordset , aliran, atau Tidak Ada.

Parameter

RecordsAffected
Pilihan. Variabel Panjang tempat penyedia mengembalikan jumlah rekaman yang terpengaruh operasi. Parameter RecordsAffected hanya berlaku untuk kueri tindakan atau prosedur tersimpan. RecordsAffected tidak mengembalikan jumlah rekaman yang dikembalikan oleh kueri yang mengembalikan hasil atau prosedur tersimpan. Untuk mendapatkan informasi ini, gunakan properti RecordCount . Metode Execute tidak akan mengembalikan informasi yang benar ketika digunakan dengan adAsyncExecute, hanya karena ketika perintah dijalankan secara asinkron, jumlah rekaman yang terpengaruh mungkin belum diketahui pada saat metode kembali.

Parameter
Opsional. Array varian nilai parameter yang digunakan bersama dengan string input atau aliran yang ditentukan dalam CommandText atau CommandStream. (Parameter output tidak akan mengembalikan nilai yang benar ketika diteruskan dalam argumen ini.)

Opsi
Pilihan. Nilai Panjang yang menunjukkan bagaimana penyedia harus mengevaluasi CommandText atau properti CommandStream dari objek Perintah. Dapat berupa nilai bitmask yang dibuat menggunakan nilai CommandTypeEnum dan/atau ExecuteOptionEnum . Misalnya, Anda dapat menggunakan adCmdText dan adExecuteNoRecords dalam kombinasi jika Anda ingin ADO mengevaluasi nilai properti CommandText sebagai teks, dan menunjukkan bahwa perintah harus membuang dan tidak mengembalikan rekaman apa pun yang mungkin dihasilkan saat teks perintah dijalankan.

Catatan

Gunakan nilai ExecuteOptionEnumadExecuteNoRecords untuk meningkatkan performa dengan meminimalkan pemrosesan internal. Jika adExecuteStream ditentukan, opsi adAsyncFetch dan adAsynchFetchNonBlocking diabaikan. Jangan gunakan nilai CommandTypeEnumadCmdFile atau adCmdTableDirect dengan Execute. Nilai-nilai ini hanya dapat digunakan sebagai opsi dengan metode Buka dan Kueri Ulang dari Recordset.

Keterangan

Menggunakan metode Jalankan pada objek Perintah menjalankan kueri yang ditentukan dalam properti CommandText atau properti CommandStream objek.

Hasil dikembalikan dalam Recordset (secara default) atau sebagai aliran informasi biner. Untuk mendapatkan aliran biner, tentukan adExecuteStream di Opsi, lalu berikan aliran dengan mengatur Command.Properties("Aliran Output"). Objek ADO Stream dapat ditentukan untuk menerima hasilnya, atau objek stream lain seperti objek Respons IIS dapat ditentukan. Jika tidak ada aliran yang ditentukan sebelum memanggil Jalankan dengan adExecuteStream, kesalahan terjadi. Posisi aliran yang dikembalikan dari Execute adalah spesifik penyedia.

Jika perintah tidak dimaksudkan untuk mengembalikan hasil (misalnya, kueri SQL UPDATE) penyedia mengembalikan Tidak ada selama opsi adExecuteNoRecords ditentukan; jika tidak, Jalankan mengembalikan Recordset tertutup. Beberapa bahasa aplikasi memungkinkan Anda mengabaikan nilai pengembalian ini jika tidak ada Recordset yang diinginkan.

Jalankan menimbulkan kesalahan jika pengguna menentukan nilai untuk CommandStream saat CommandType adalah adCmdStoredProc, adCmdTable, atau adCmdTableDirect.

Jika kueri memiliki parameter, nilai saat ini untuk parameter objek Perintah digunakan kecuali Anda mengambil alih ini dengan nilai parameter yang diteruskan dengan panggilan Jalankan . Anda dapat mengganti subset parameter dengan menghilangkan nilai baru untuk beberapa parameter saat memanggil metode Execute . Urutan di mana Anda menentukan parameter adalah urutan yang sama di mana metode melewatinya. Misalnya, jika ada empat parameter (atau lebih) dan Anda ingin meneruskan nilai baru hanya untuk parameter pertama dan keempat, Anda akan meneruskan Array(var1,,,var4) sebagai argumen Parameter .

Catatan

Parameter output tidak akan mengembalikan nilai yang benar ketika diteruskan dalam argumen Parameter .

Peristiwa ExecuteComplete akan dikeluarkan ketika operasi ini selesai.

Catatan

Saat mengeluarkan perintah yang berisi URL, mereka yang menggunakan skema http akan secara otomatis memanggil Penyedia Microsoft OLE DB untuk Penerbitan Internet. Untuk informasi selengkapnya, lihat URL Absolut dan Relatif.

Berlaku Untuk

Objek Perintah (ADO)

Lihat juga

Contoh Metode Eksekusi, Kueri Ulang, dan Hapus (VB)
Contoh Metode Jalankan, Kueri Ulang, dan Hapus (VBScript)
Contoh Metode Jalankan, Kueri Ulang, dan Hapus (VC++)
Properti CommandStream (ADO)
Properti CommandText (ADO)
CommandTypeEnum
Metode Eksekusi (Koneksi ADO)
Kejadian ExecuteComplete (ADO)