Metode Jalankan (Perintah ADO)

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

Sintaksis

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

Mengembalikan Nilai

Mengembalikan referensi objek Recordset, aliran, atau Tidak Ada yang.

Parameter

RecordAffected
Fakultatif. Variabel Long 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 dikembalikan 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
Fakultatif. Array Varian dari 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
Fakultatif. 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.

Nota

Gunakan nilai ExecuteOptionEnum adExecuteNoRecords untuk meningkatkan performa dengan meminimalkan pemrosesan internal. Jika adExecuteStream ditentukan, opsi adAsyncFetch dan adAsynchFetchNonBlocking diabaikan. Jangan gunakan nilai CommandTypeEnum adCmdFile atau adCmdTableDirect dengan Jalankan. Nilai-nilai ini hanya dapat digunakan sebagai opsi dengan metode Open dan Requery dari Recordset .

Komentar

Menggunakan metode Execute 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 penyedia khusus.

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

Execute menimbulkan kesalahan jika pengguna menentukan nilai untuk CommandStream saat CommandType 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 mengambil alih subset parameter dengan menghilangkan nilai baru untuk beberapa parameter saat memanggil metode Jalankan. 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 parameter argumen.

Nota

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

Peristiwa executecomplete akan dikeluarkan ketika operasi ini selesai.

Nota

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

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