>Resync Method

Refreshes the data in the current Recordset object from the underlying database.

Syntax

recordset.Resync AffectRecords

The Resync method syntax has these parts:

Part

Description

recordset

An object variable representing an open Recordset object.

AffectRecords

Optional. A Long expression that determines on how many records the Resync method should act. Can be one of the following constants:

adAffectCurrent, 1 - Refresh only the current record.

adAffectGroup, 2 - Refresh the records that satisfy the current Filter property setting. You must set the Filter property to one of the valid predefined constants in order to use this option.

adAffectAll, 3 (Default) - Refresh all the records in the Recordset object, including any hidden by the current Filter property setting.

Remarks

Use the Resync method to re-synchronize records in the current Recordset with the underlying database. This is useful if you are using either a static or forward-only cursor but you want to see any changes in the underlying database. Calling the Resync method cancels any pending batch updates.

Unlike the Refresh method, the Resync method does not re-execute the Recordset object's underlying command; new records in the underlying database will not be visible.

If the attempt to resynchronize fails because of a conflict with the underlying data (for example, a record has been deleted by another user), the provider returns warnings to the Errors collection but does not halt program execution. A run-time error occurs only if there are conflicts on all the requested records. Use the Filter property (adFilterAffectedRecords) and the Status property to locate records with conflicts.