Metode Sinkronisasi (RDS)

Sinkronkan Kumpulan Rekaman yang diberikan dengan database yang ditentukan oleh string koneksi 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 Windows Server 2012 Compatibility Cookbook 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.

Sintaksis

  
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)  

Parameter

ConnectionString
String yang digunakan untuk menyambungkan ke penyedia OLE DB tempat permintaan akan dikirim. Jika handler digunakan, handler 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) 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 mungkin berisi koma tambahan). Argumen bersifat opsional.

lSynchronizeOptions
Sedikit masker opsi sinkronisasi.

1=UpdateTransact Pembaruan ke database dibungkus dalam transaksi. Transaksi dibatalkan jika salah satu pembaruan gagal.

2=RefreshWithUpdate Menyebabkan status baris dikembalikan saat refresh atau RefreshConflicts diatur.

4=Refresh Kumpulan rekaman di-refresh dengan data saat ini dari database. Pembaruan tertunda tidak didorong ke database. Jika bit ini tidak diatur, kumpulan rekaman tidak disegarkan, dan pembaruan yang tertunda didorong ke database.

8=RefreshConflicts Baris apa pun dengan perubahan tertunda gagal diperbarui. Baris yang gagal diperbarui di-refresh dengan data saat ini dari database.

ppRecordset
Penunjuk ke kumpulan rekaman yang akan disinkronkan.

pStatusArray
Varian yang digunakan untuk mengembalikan array status baris yang aman untuk baris yang terpengaruh oleh sinkronisasi. Tidak diatur jika tidak ada opsi sinkronisasi berikut yang diatur: RefreshWithUpdate, Refresh dan RefreshConflicts.

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.

Komentar

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 kemudian akan menginterpretasikan argumen sebagai arah untuk menggunakan sample.ini untuk memeriksa string koneksi dan kueri.

Berlaku Untuk

DataFactory Object (RDSServer)