Koleksi Parameter (ADO)

Berisi semua objek Parameter objek Perintah .

Keterangan

Objek Perintah memiliki koleksi Parameter yang terdiri dari objek Parameter .

Menggunakan metode Refresh pada koleksi Parameter objek Perintah mengambil informasi parameter penyedia untuk prosedur tersimpan atau kueri berparameter yang ditentukan dalam objek Perintah. Beberapa penyedia tidak mendukung panggilan prosedur tersimpan atau kueri berparameter; memanggil metode Refresh pada koleksi Parameter saat menggunakan penyedia tersebut akan mengembalikan kesalahan.

Jika Anda belum menentukan objek Parameter Anda sendiri dan Anda mengakses koleksi Parameter sebelum memanggil metode Refresh , ADO akan secara otomatis memanggil metode dan mengisi koleksi untuk Anda.

Anda dapat meminimalkan panggilan ke penyedia untuk meningkatkan performa jika Anda mengetahui properti parameter yang terkait dengan prosedur tersimpan atau kueri berparameter yang ingin Anda panggil. Gunakan metode CreateParameter untuk membuat objek Parameter dengan pengaturan properti yang sesuai dan gunakan metode Tambahkan untuk menambahkannya ke koleksi Parameter . Ini memungkinkan Anda mengatur dan mengembalikan nilai parameter tanpa harus memanggil penyedia untuk informasi parameter. Jika Anda menulis ke penyedia yang tidak menyediakan informasi parameter, Anda harus mengisi koleksi Parameter secara manual menggunakan metode ini untuk dapat menggunakan parameter sama sekali. Gunakan metode Hapus untuk menghapus objek Parameter dari koleksi Parameter jika perlu.

Objek dalam kumpulan ParameterRecordset keluar dari cakupan (karena itu menjadi tidak tersedia) saat Recordset ditutup.

Saat memanggil prosedur tersimpan dengan Perintah, parameter nilai/output yang dikembalikan dari prosedur tersimpan diambil sebagai berikut:

1. Saat memanggil prosedur tersimpan yang tidak memiliki parameter, metode Refresh pada koleksi Parameter harus dipanggil sebelum memanggil metode Jalankan pada objek Perintah .

2. Saat memanggil prosedur tersimpan dengan parameter dan secara eksplisit menambahkan parameter ke koleksi Parameter dengan Tambahkan, parameter nilai/output yang dikembalikan harus ditambahkan ke koleksi Parameter . Nilai yang dikembalikan harus terlebih dahulu ditambahkan ke koleksi Parameter . Gunakan Tambahkan untuk menambahkan parameter lain ke dalam koleksi Parameter dalam urutan definisi. Misalnya, prosedur tersimpan SPWithParam memiliki dua parameter. Parameter pertama, InParam, adalah parameter input yang didefinisikan sebagai adVarChar (20), dan parameter kedua, OutParam, adalah parameter output yang didefinisikan sebagai adVarChar (20). Anda dapat mengambil parameter nilai/output yang dikembalikan dengan kode berikut.

   ' Open Connection Conn  
   set ccmd = CreateObject("ADODB.Command")  
   ccmd.Activeconnection= Conn  
   
   ccmd.CommandText="SPWithParam"  
   ccmd.commandType = 4 'adCmdStoredProc  
   
   ccmd.parameters.Append ccmd.CreateParameter(, adInteger, adParamReturnValue, , NULL)   ' return value  
   ccmd.parameters.Append ccmd.CreateParameter("InParam", adVarChar, adParamInput, 20, "hello world")   ' input parameter  
   ccmd.parameters.Append ccmd.CreateParameter("OutParam", adVarChar, adParamOutput, 20, NULL)   ' output parameter  
   
   ccmd.execute()  
   
   ' Access ccmd.parameters(0) as return value of this stored procedure  
   ' Access ccmd.parameters("OutParam") as the output parameter of this stored procedure.  
   
   

3. Saat memanggil prosedur tersimpan dengan parameter dan mengonfigurasi parameter dengan memanggil metode Item pada koleksi Parameter , parameter nilai/output yang dikembalikan dari prosedur tersimpan dapat diambil dari koleksi Parameter . Misalnya, prosedur tersimpan SPWithParam memiliki dua parameter. Parameter pertama, InParam, adalah parameter input yang didefinisikan sebagai adVarChar (20), dan parameter kedua, OutParam, adalah parameter output yang didefinisikan sebagai adVarChar (20). Anda dapat mengambil parameter nilai/output yang dikembalikan dengan kode berikut.

   ' Open Connection Conn  
   set ccmd = CreateObject("ADODB.Command")  
   ccmd.Activeconnection= Conn  
   
   ccmd.CommandText="SPWithParam"  
   ccmd.commandType = 4 'adCmdStoredProc  
   
   ccmd.parameters.Item("InParam").value = "hello world" ' input parameter  
   ccmd.execute()  
   
   ' Access ccmd.parameters(0) as return value of stored procedure  
   ' Access ccmd.parameters(2) or ccmd.parameters("OutParam") as the output parameter.  
   

Bagian ini berisi topik berikut.

• Properti, Metode, dan Peristiwa Pengumpulan Parameter

Lihat juga

Metode Tambahan (ADO)
Metode CreateParameter (ADO)
Objek Parameter