Metode Eksekusi (RDS)

  • Artikel

Menjalankan permintaan dan membuat kumpulan catatan ADO untuk digunakan di ADO 2.5 dan yang lebih baru.

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.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])

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 dua bagian yang mengidentifikasi handler yang akan digunakan dengan eksekusi ini. String berisi dua bagian. Bagian pertama berisi nama (ProgID) dari handler yang akan digunakan. Bagian kedua berisi argumen yang akan diteruskan ke handler. Detail bagaimana string argumen ditafsirkan khusus untuk setiap handler. Dua bagian dipisahkan oleh instans pertama koma dalam string. 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, QueryString mungkin berisi pernyataan perintah Transact-SQL, tetapi untuk penyedia non-SQL (misalnya, MSDataShape) ini mungkin bukan pernyataan kueri Transact-SQL.

Jika handler sedang 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.

lFetchOptions
Menunjukkan jenis pengambilan asinkron.

Untuk informasi selengkapnya, lihat Properti FetchOptions (RDS).

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 dan nilai yang ditentukan di sini dan parameter QueryString diabaikan.

lExecuteOptions
Sedikit masker 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.

ReadOnly, NoBatch dan GetHiddenColumns adalah opsi yang saling eksklusif; namun, itu tidak menghasilkan 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 kolom adLockBatchOptimistic dan 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 bisa kosong.

Icid
LCID yang digunakan untuk membangun kesalahan apa pun yang dikembalikan dalam pInformation.

pInformation
Penunjuk ke kesalahan informasi yang dikembalikan oleh Jalankan. Jika NULL, tidak ada informasi kesalahan yang dikembalikan.

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.

Berlaku Untuk

Objek DataFactory (RDSServer)