Metode Sinkronisasi Ulang

Artikel
05/30/2023

Merefresh data dalam objek Recordset saat ini, atau kumpulan Bidang dari objek Rekaman, dari database yang mendasar.

Sintaks

  
Recordset.Resync AffectRecords, ResyncValues Record.Fields.Resync ResyncValues

Parameter

AffectRecords
Opsional. Nilai AffectEnum yang menentukan berapa banyak rekaman yang akan memengaruhi metode Sinkronisasi Ulang . Nilai defaultnya adalah adAffectAll. Nilai ini tidak tersedia dengan metode Sinkronkan ulang kumpulan Bidang dari objek Rekaman .

ResyncValues
Pilihan. Nilai ResyncEnum yang menentukan apakah nilai yang mendasar ditimpa. Nilai defaultnya adalah adResyncAllValues.

Keterangan

Recordset

Gunakan metode Resync untuk menyinkronkan ulang rekaman di Recordset saat ini dengan database yang mendasar. Ini berguna jika Anda menggunakan kursor statis atau hanya maju, tetapi Anda ingin melihat perubahan apa pun dalam database yang mendasar.

Jika Anda mengatur properti CursorLocation ke adUseClient, Sinkronisasi ulang hanya tersedia untuk objek Recordset non-baca-saja.

Tidak seperti metode Kueri Ulang , metode Resync tidak menjalankan kembali perintah yang mendasar objek Recordset . Rekaman baru dalam database yang mendasar tidak akan terlihat.

Jika upaya untuk menyinkronkan ulang gagal karena konflik dengan data yang mendasarinya (misalnya, rekaman telah dihapus oleh pengguna lain), penyedia mengembalikan peringatan ke koleksi Kesalahan dan kesalahan run-time terjadi. Gunakan properti Filter (adFilterConflictingRecords) dan properti Status untuk menemukan rekaman yang berkonflik.

Jika properti dinamis Tabel Unik dan Perintah Sinkronisasi Ulang diatur, dan Recordset adalah hasil dari menjalankan operasi JOIN pada beberapa tabel, maka metode Sinkronisasi Ulang akan menjalankan perintah yang diberikan dalam properti Perintah Sinkronisasi Ulang hanya pada tabel bernama di properti Tabel Unik .

Bidang

Gunakan metode Resync untuk menyinkronkan ulang nilai kumpulan Bidang dari objek Rekaman dengan sumber data yang mendasar. Properti Hitung tidak terpengaruh oleh metode ini.

Jika ResyncValues diatur ke adResyncAllValues (nilai default), properti UnderlyingValue, Value, dan OriginalValue objek Bidang dalam koleksi disinkronkan. Jika ResyncValues diatur ke adResyncUnderlyingValues, hanya properti UnderlyingValue yang disinkronkan.

Nilai properti Status untuk setiap objek Bidang pada saat panggilan juga memengaruhi perilaku Sinkronisasi Ulang. Untuk objek Bidang yang memiliki nilai StatusadFieldPendingUnknown atau adFieldPendingInsert, Resync tidak berpengaruh. Untuk nilai StatusadFieldPendingChange atau adFieldPendingDelete, Sinkronisasi ulang menyinkronkan nilai data untuk bidang yang masih ada di sumber data.

Sinkronisasi ulang tidak akan mengubah nilai Status objek Bidang kecuali terjadi kesalahan saat Sinkronisasi Ulang dipanggil. Misalnya, jika bidang tidak ada lagi, penyedia akan mengembalikan nilai Status yang sesuai untuk objek Bidang , seperti adFieldDoesNotExist. Nilai Status yang Dikembalikan dapat digabungkan secara logis dalam nilai properti Status .