Metode Execute21 (RDS)

  • Artikel

Menjalankan permintaan dan membuat kumpulan catatan ADO untuk digunakan dalam ADO 2.1.

Penting

Dimulai dengan Windows 8 dan Windows Server 2012, komponen server RDS tidak lagi disertakan dalam sistem operasi Windows (lihat Windows 8 dan Buku Masak Kompatibilitas Windows Server 2012 untuk detail selengkapnya). Komponen klien RDS akan dihapus dalam versi Windows yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Aplikasi yang menggunakan RDS harus bermigrasi ke WCF Data Service.

Sintaks

  
object.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)

Parameter

ConnectionString
String yang digunakan untuk menyambungkan ke penyedia OLE DB tempat permintaan akan dikirim untuk eksekusi. Jika handler ditentukan dengan menggunakan HandlerString, handlerString dapat mengedit atau mengganti string koneksi.

HandlerString
String mengidentifikasi handler yang akan digunakan dengan eksekusi ini. String berisi dua bagian. Bagian pertama berisi nama (ProgID) dari handler yang akan digunakan. Bagian kedua dari string berisi argumen yang akan diteruskan ke handler. Bagaimana string argumen ditafsirkan adalah handler spesifik. Dua bagian dipisahkan oleh instans pertama koma dalam string (meskipun string argumen dapat berisi koma tambahan). Argumen bersifat opsional.

QueryString
Perintah dalam bahasa perintah yang didukung oleh penyedia OLE DB yang diidentifikasi dalam string koneksi. Untuk penyedia berbasis SQL, mungkin berisi pernyataan perintah Transact-SQL, tetapi untuk penyedia non-SQL (misalnya, MSDataShape) ini mungkin bukan pernyataan kueri Transact-SQL.

Selain itu, jika handler sedang digunakan (dan sangat disarankan agar handler digunakan), handler dapat mengubah atau mengganti nilai yang ditentukan di sini. Misalnya, handler biasanya mengganti QueryString dengan string kueri dari file .ini-nya. Secara default, file Msdfmap.ini digunakan.

lMarshalOptions
Digunakan untuk mengatur opsi marshaling pada rowset/recordset yang dikembalikan.

TABLEID
Varian jenis baik VT_EMPTY atau VT_BSTR. Jika nilai ini berjenis VT_EMPTY, nilai tersebut akan diabaikan. Jika berjenis VT_BSTR, kumpulan rekaman dibuat dengan menggunakan adCmdTableDirect menggunakan nilai yang ditentukan di sini dan parameter QueryString diabaikan.

lExecuteOptions
Bitmask opsi eksekusi:

1=ReadOnly Recordset akan dibuka dengan menggunakan adLockReadOnly.

2=NoBatch Recordset akan dibuka dengan menggunakan adLockOptimistic.

4=AllParamInfoSupplied Pemanggil menjamin bahwa informasi parameter untuk semua parameter disediakan dalam pParameters.

8=Informasi Parameter GetInfo untuk kueri akan diperoleh dari penyedia OLE DB dan dikembalikan dalam parameter pParameters . Kueri tidak dijalankan dan tidak ada set rekaman yang dikembalikan.

16=GetHiddenColumns Recordset akan dibuka dengan menggunakan adLockBatchOptimistic dan kolom tersembunyi apa pun akan disertakan dalam recordset.

Meskipun ReadOnly, NoBatch dan GetHiddenColumns adalah opsi yang saling eksklusif, ini bukan kesalahan untuk mengatur lebih dari satu dari mereka. Jika beberapa opsi diatur, GetHiddenColumns lebih diutamakan daripada semua opsi lainnya, diikuti oleh ReadOnly. Jika tidak ada opsi yang ditentukan, secara default, recordset dibuka dengan menggunakan adLockBatchOptimistic tetapi kolom tersembunyi tidak disertakan dalam recordset.

pParameters
Varian yang berisi array definisi parameter yang aman. Jika opsi GetInfo ditentukan dalam lExecuteOptions, parameter ini digunakan untuk mengembalikan definisi parameter yang diperoleh dari penyedia OLE DB. Jika tidak, parameter ini mungkin kosong.

Keterangan

Parameter HandlerString mungkin null. Apa yang terjadi dalam kasus ini tergantung pada bagaimana server RDS dikonfigurasi. String handler "MSDFMAP.handler" menunjukkan bahwa handler yang disediakan Microsoft (Msdfmap.dll) harus digunakan. String handler "MASDFMAP.handler,sample.ini" menunjukkan bahwa handler Msdfmap.dll harus digunakan dan bahwa argumen "sample.ini" harus diteruskan ke handler. MSDFMAP.dll akan menginterpretasikan argumen sebagai arah untuk menggunakan sample.ini untuk memeriksa string koneksi dan kueri.

Catatan

Metode Execute21 adalah versi metode Execute (RDS). Jika Anda perlu menggunakan metode Execute untuk berkomunikasi dengan ADO 2.1, metode Execute21 dapat dipanggil sebagai gantinya. Kemampuan metode Execute di ADO 2.5 dan yang lebih baru adalah superset dari kemampuan yang disediakan untuk metode yang sama di ADO 2.1.

Berlaku Untuk

Objek DataFactory (RDSServer)