Objek DataControl (RDS)

Mengikat Kumpulan rekaman kueri data ke satu atau beberapa kontrol (misalnya, kotak teks, kontrol kisi, atau kotak kombo) untuk menampilkan data Kumpulan rekaman di halaman Web.

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 di 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 Layanan Data WCF.

Sintaks

  
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"  
   <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=MyPassword;">  
   <PARAM NAME="Server" VALUE="https://awebsrvr">  
   <PARAM NAME="SQL" VALUE="QueryText">  
</OBJECT>  

Keterangan

ID kelas untuk RDS. Objek DataControl adalah BD96C556-65A3-11D0-983A-00C04FC29E33.

Catatan

Jika Anda mendapatkan kesalahan bahwa RDS. DataSpace atau RDS. Objek DataControl tidak dimuat, pastikan Anda menggunakan ID kelas yang benar. ID kelas untuk objek ini telah berubah dari versi 1.0 dan 1.1. Selain itu, ketahuilah bahwa bahkan kolom yang dapat diubah ke null harus diatur saat Anda menggunakan objek RDS DataControl .

Untuk skenario dasar, Anda hanya perlu mengatur properti SQL, Connect, dan Server dari RDS. Objek DataControl , yang akan secara otomatis memanggil objek bisnis default, RDSServer.DataFactory.

Semua properti dalam RDS. DataControl bersifat opsional karena objek bisnis kustom dapat menggantikan fungsionalitasnya.

Catatan

Jika Anda mengkueri beberapa hasil, hanya Recordset pertama yang dikembalikan. Jika beberapa tataan hasil diperlukan, tetapkan masing-masing ke DataControl-nya sendiri. Contoh kueri untuk beberapa hasil bisa menjadi berikut: "Select * from Authors, Select * from Topics"

Menambahkan "DFMode=20;" ke string koneksi Anda saat Anda menggunakan RDS. Objek DataControl dapat meningkatkan performa server Anda saat Anda memperbarui data. Dengan pengaturan ini, objek RDSServer.DataFactory di server menggunakan mode yang kurang intensif sumber daya. Namun, fitur berikut tidak tersedia dalam konfigurasi ini:

  • Menggunakan kueri berparameter.

  • Mendapatkan informasi parameter atau kolom sebelum memanggil metode Execute .

  • Mengatur Updates Bertransaksi ke True.

  • Mendapatkan status baris.

  • Memanggil metode Resync .

  • Menyegarkan (secara eksplisit atau otomatis) melalui properti Perbarui Sinkronisasi Ulang .

  • Mengatur properti Perintah atau Recordset .

  • Menggunakan adCmdTableDirect.

Para RDS. Objek DataControl berjalan dalam mode asinkron secara default. Jika Anda memerlukan eksekusi sinkron untuk aplikasi Anda, atur parameter ExecuteOptions sama dengan adcExecSync dan parameter FetchOptions sama dengan adcFetchUpFront, seperti yang ditunjukkan dalam contoh berikut.

<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33"   
    ID="DataControl"  
   <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=MyPassword;">  
   <PARAM NAME="Server" VALUE="https://awebsrvr">  
   <PARAM NAME="SQL" VALUE="QueryText">  
   <PARAM NAME="ExecuteOptions" VALUE="1">   <PARAM NAME="FetchOptions" VALUE="1">  
</OBJECT>  

Gunakan satu RDS. Objek DataControl untuk menautkan hasil satu kueri ke satu atau beberapa kontrol visual. Misalnya, Anda membuat kode kueri yang meminta data pelanggan seperti Nama, Tempat Tinggal, Tempat Lahir, Usia, dan Status Pelanggan Prioritas. Anda dapat menggunakan satu RDS. Objek DataControl untuk menampilkan Nama, Usia, dan Wilayah pelanggan dalam tiga kotak teks terpisah; Status Pelanggan Prioritas dalam kotak centang; dan semua data dalam kontrol kisi.

Gunakan RDS yang berbeda. Objek DataControl untuk menautkan hasil beberapa kueri ke kontrol visual yang berbeda. Misalnya, Anda menggunakan satu kueri untuk mendapatkan informasi tentang pelanggan, dan kueri kedua untuk mendapatkan informasi tentang barang dagangan yang telah dibeli pelanggan. Anda ingin menampilkan hasil kueri pertama dalam tiga kotak teks dan satu kotak centang, dan hasil kueri kedua dalam kontrol kisi. Jika Anda menggunakan objek bisnis default (RDSServer.DataFactory), Anda harus melakukan hal berikut:

  • Tambahkan dua RDS. Objek DataControl ke halaman Web Anda.

  • Tulis dua kueri, satu untuk setiap properti SQL dari dua RDS. Objek DataControl . Satu RDS. Objek DataControl akan berisi kueri SQL yang meminta informasi pelanggan; yang kedua akan berisi kueri yang meminta daftar barang dagangan yang telah dibeli pelanggan.

  • Dalam tag OBJECT dari setiap kontrol terikat, tentukan nilai DATAFLD untuk mengatur nilai untuk data yang ingin Anda tampilkan di setiap kontrol visual.

Tidak ada batasan hitungan pada jumlah RDS. Objek DataControl yang bisa Anda sematkan dengan menggunakan tag OBJECT pada satu halaman Web.

Saat Anda menentukan RDS. Objek DataControl pada halaman Web, gunakan nilai Tinggi dan Lebar bukan nol seperti 1 (untuk menghindari penyertaan ruang ekstra).

Komponen klien Layanan Data Jarak Jauh sudah disertakan sebagai bagian dari Internet Explorer 4.0; oleh karena itu, Anda tidak perlu menyertakan parameter CODEBASE dalam RDS Anda. Tag objek DataControl .

Dengan Internet Explorer 4.0 atau yang lebih baru, Anda dapat mengikat data dengan menggunakan kontrol HTML dan kontrol ActiveX® hanya jika ditandai sebagai kontrol model apartemen.

Catatan

Pengguna Microsoft Visual BasicPara RDS. DataControl aman untuk pembuatan skrip dan hanya digunakan dalam aplikasi berbasis Web. Aplikasi klien Visual Basic tidak memerlukannya.

Bagian ini berisi topik berikut.

Lihat juga

Contoh Objek DataControl (VBScript)