Resync 方法

從基礎資料庫重新整理目前記錄集物件中的資料,或記錄物件的欄位集合中的資料。

語法

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

參數

AffectRecords
選擇性。 AffectEnum值,可決定重新 同步 方法將會影響的記錄數目。 預設值為 adAffectAll記錄 物件之 Fields 集合的 Resync 方法無法使用這個值。

ResyncValues
選擇性。 指定是否覆寫基礎值的 ResyncEnum 值。 預設值為 adResyncAllValues

備註

資料錄集

使用 Resync 方法可將目前 記錄集 內的記錄與基礎資料庫重新同步處理。 如果您使用靜態或順向資料指標,但您想要查看基礎資料庫中的任何變更,這會很有用。

如果您將 CursorLocation 屬性設定為 adUseClient,則 [重新 同步 處理] 只適用于非唯讀的 記錄集 物件。

Requery 方法不同的是, Resync 方法不會重新執行 記錄集 物件的基礎命令。 基礎資料庫中的新記錄將不會顯示。

如果嘗試重新同步處理失敗,因為與基礎資料相衝突 (例如,其他使用者) 已刪除記錄,則提供者會將警告傳回至 錯誤 集合,併發生執行階段錯誤。 使用 Filter 屬性 (AdFilterConflictingRecords) 和 Status 屬性來尋找有衝突的記錄。

如果已設定 Unique tableResync 命令動態屬性,而且 記錄集 是在多個資料表上執行聯結作業的結果,則 resync 方法只會在 Unique Table 屬性中命名的資料表上,執行 resync 命令 屬性中提供的命令。

欄位

使用 Resync 方法,將 Record 物件的 Fields 集合值與基礎資料來源重新同步。 Count屬性不受此方法影響。

如果 ResyncValues 設定為 adResyncAllValues (預設值) ,則會同步處理集合中 欄位物件的 UnderlyingValuevalueOriginalValue屬性。 如果 ResyncValues 設定為 adResyncUnderlyingValues,則只會同步處理 UnderlyingValue 屬性。

在呼叫時,每個 欄位 物件的 Status 屬性值也會影響重新 同步 的行為。 對於具有 adFieldPendingUnknown 或 adFieldPendingInsert 狀態值欄位 物件, Resync 沒有任何作用。 針對 adFieldPendingChangeadFieldPendingDelete狀態值Resync 會同步處理仍存在於資料來源之欄位的資料值。

除非在呼叫重新 同步 時發生錯誤,否則重新 同步 處理不會修改 欄位 物件的 狀態值。 例如,如果欄位已不存在,則提供者會為 field 物件傳回適當的 狀態值,例如 adFieldDoesNotExist。 傳回的 狀態值 可以邏輯方式結合在 Status 屬性的值內。

套用至

另請參閱

Resync 方法範例 (VB)
Resync 方法範例 (VC++)
(ADO) 的 Clear 方法
UnderlyingValue 屬性