Gambaran Umum Penyedia Jarak Jauh Microsoft OLE DB
Penyedia Jarak Jauh Microsoft OLE DB memungkinkan pengguna lokal pada komputer klien untuk memanggil penyedia data di komputer jarak jauh. Tentukan parameter penyedia data untuk komputer jarak jauh seperti yang Anda lakukan jika Anda adalah pengguna lokal di komputer jarak jauh. Kemudian tentukan parameter yang digunakan oleh Penyedia Jarak Jauh untuk mengakses komputer jarak jauh. Anda kemudian dapat mengakses komputer jarak jauh seolah-olah Anda adalah pengguna lokal.
Penting
Dimulai dengan Windows 8 dan Windows Server 2012, komponen server RDS tidak lagi disertakan dalam sistem operasi Windows (lihat Buku Masak Kompatibilitas Windows 8 dan 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 WCF Data Service.
Kata Kunci Penyedia
Untuk memanggil Penyedia Jarak Jauh OLE DB, tentukan kata kunci dan nilai berikut dalam string koneksi. (Perhatikan ruang kosong dalam nama penyedia.)
"Provider=MS Remote"
Kata Kunci Tambahan
Ketika penyedia layanan ini dipanggil, kata kunci tambahan berikut relevan.
| Kata kunci | Deskripsi |
|---|---|
| Sumber data | Menentukan nama sumber data jarak jauh. Ini diteruskan ke Penyedia Jarak Jauh OLE DB untuk diproses. Kata kunci ini setara dengan RDS. Properti Koneksi objek DataControl. |
Properti Dinamis
Ketika penyedia layanan ini dipanggil, properti dinamis berikut ditambahkan ke koleksi Properti objek Koneksi ion.
| Nama Properti Dinamis | Deskripsi |
|---|---|
| DFMode | Menunjukkan Mode DataFactory. String yang menentukan versi objek DataFactory yang diinginkan di server. Atur properti ini sebelum membuka koneksi untuk meminta versi DataFactory tertentu. Jika versi yang diminta tidak tersedia, upaya akan dilakukan untuk menggunakan versi sebelumnya. Jika tidak ada versi sebelumnya, kesalahan akan terjadi. Jika DFMode kurang dari versi yang tersedia, kesalahan akan terjadi. Properti ini bersifat baca-saja setelah koneksi dibuat. Bisa menjadi salah satu nilai string yang valid berikut ini: - "25"-Versi 2.5 (Default) - "21"-Versi 2.1 - "20"-Versi 2.0 - "15"-Versi 1.5 |
| Properti Perintah | Menunjukkan nilai yang akan ditambahkan ke string properti perintah (rowset) yang dikirim ke server oleh penyedia MS Remote. Nilai default untuk string ini adalah vt_empty. |
| DFMode Saat Ini | Menunjukkan nomor versi aktual DataFactory di server. Periksa properti ini untuk melihat apakah versi yang diminta di properti DFMode telah dihormati. Bisa menjadi salah satu nilai bilangan bulat Panjang yang valid berikut ini: - 25-Versi 2.5 (Default) - 21-Versi 2.1 - 20-Versi 2.0 - 15-Versi 1.5 Menambahkan "DFMode=20;" ke string koneksi Anda saat menggunakan penyedia MSRemote dapat meningkatkan performa server Anda saat 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 Pembaruan Bertransaksi ke True. - Mendapatkan status baris. - Memanggil metode Resync . - Refresh (secara eksplisit atau otomatis) melalui properti Perbarui Sinkronisasi Ulang . - Mengatur properti Perintah atau Recordset . - Menggunakan adCmdTableDirect. |
| Handler | Menunjukkan nama program kustomisasi sisi server (atau handler) yang memperluas fungsionalitas RDSServer.DataFactory, dan parameter apa pun yang digunakan oleh handler, semuanya dipisahkan oleh koma (","). Nilai string . |
| Batas Waktu Internet | Menunjukkan jumlah maksimum milidetik untuk menunggu permintaan untuk melakukan perjalanan ke dan dari server. (Defaultnya adalah 5 menit.) |
| Penyedia Jarak Jauh | Menunjukkan nama penyedia data yang akan digunakan di server jarak jauh. |
| Server Jarak Jauh | Menunjukkan nama server dan protokol komunikasi yang akan digunakan oleh koneksi ini. Properti ini setara dengan RDS. Properti Server objek DataContro. |
| Pembaruan Bertransaksi | Ketika diatur ke True, nilai ini menunjukkan bahwa ketika UpdateBatch dilakukan di server, nilai ini akan dilakukan di dalam transaksi. Nilai default untuk properti dinamis Boolean ini adalah False. |
Anda juga dapat mengatur properti dinamis yang dapat ditulis dengan menentukan namanya sebagai kata kunci dalam string koneksi. Misalnya, atur properti dinamis Batas Waktu Internet ke lima detik dengan menentukan:
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Internet Timeout=5000"
Anda juga dapat mengatur atau mengambil properti dinamis dengan menentukan namanya sebagai indeks ke properti Properti . Contoh berikut menunjukkan cara mendapatkan dan mencetak nilai properti dinamis Batas Waktu Internet saat ini, lalu mengatur nilai baru:
Debug.Print cn.Properties("Internet Timeout")
cn.Properties("Internet Timeout") = 5000
Keterangan
Dalam ADO 2.0, Penyedia Jarak Jauh OLE DB hanya dapat ditentukan dalam parameter Aktif Koneksi ion dari metode Buka objek Recordset. Dimulai dengan ADO 2.1, penyedia juga dapat ditentukan dalam parameter Koneksi ionString dari metode Buka objek Koneksi ion.
Setara dengan RDS. Properti SQL objek DataControl tidak tersedia. Argumen Sumber metode Terbuka objek Recordset digunakan sebagai gantinya.
Catatan Menentukan "...; Penyedia Jarak Jauh=MS Jarak Jauh;..." akan membuat skenario empat tingkat. Skenario di luar tiga tingkatan belum diuji dan seharusnya tidak diperlukan.
Contoh
Contoh ini melakukan kueri pada tabel Penulis database Pub di server bernama YourServer. Nama sumber data jarak jauh dan server jarak jauh disediakan dalam metode Buka objek Koneksi ion, dan kueri SQL ditentukan dalam metode Buka objek Recordset. Objek Recordset dikembalikan, diedit, dan digunakan untuk memperbarui sumber data.
Dim rs as New ADODB.Recordset
Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Data Source=pubs;" & _
"Remote Server=https://YourServer"
rs.Open "SELECT * FROM authors", cn
... 'Edit the recordset
rs.UpdateBatch 'Equivalent of RDS SubmitChanges
...
Lihat Juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk