Метод ресинхронизации

Обновляет данные в текущем объекте Recordset или коллекции Полей объекта Record из базовой базы данных.

Синтаксис

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

Параметры

AffectRecords
Необязательно. Значение AffectEnum , определяющее, сколько записей будет влиять на метод Resync . Значение по умолчанию — adAffectAll. Это значение недоступно с помощью метода Resync коллекции Fields объекта Record .

ResyncValues
Необязательно. Значение ResyncEnum , указывающее, перезаписываются ли базовые значения. Значение по умолчанию — adResyncAllValues.

Замечания

Набор записей

Используйте метод Resync для повторной синхронизации записей в текущем наборе записей с базовой базой данных. Это полезно, если вы используете статический или перенаправленный курсор, но вы хотите увидеть любые изменения в базовой базе данных.

Если для свойства CursorLocation задано значение adUseClient, resync доступен только для объектов набора записей , не доступных только для чтения.

В отличие от метода Requery , метод Resync не повторно выполняет базовую команду объекта Recordset . Новые записи в базовой базе данных не будут видимыми.

Если попытка повторной синхронизации завершается ошибкой из-за конфликта с базовыми данными (например, запись была удалена другим пользователем), поставщик возвращает предупреждения в коллекцию ошибок и возникает ошибка во время выполнения. Используйте свойство Filter (adFilterConflictingRecords) и свойство Status для поиска записей с конфликтами.

Если заданы динамические свойства команды Unique Table и Resync Command , и набор записей является результатом выполнения операции JOIN в нескольких таблицах, метод Resync выполнит команду, указанную в свойстве Resync Command только в таблице с именем в свойстве Unique Table .

Поля

Используйте метод Resync для повторной синхронизации значений коллекции Полей объекта Record с базовым источником данных. Свойство Count не влияет на этот метод.

Если для ResyncValues задано значение adResyncAllValues (значение по умолчанию), свойства UnderlyingValue, Value и OriginalValue объектов Field в коллекции синхронизируются. Если для ResyncValues задано значение adResyncUnderlyingValues, синхронизируется только свойство UnderlyingValue.

Значение свойства Status для каждого объекта Field во время вызова также влияет на поведение Resync. Для объектов Field , имеющих значения состоянияadFieldPendingUnknown или adFieldPendingInsert, Resync не действует. Для значений statusadFieldPendingChange или adFieldPendingDeleteresync синхронизирует значения данных для полей, которые по-прежнему существуют в источнике данных.

Повторная синхронизация не изменяет значения состояния объектов Field , если не возникает ошибка при вызове повторной синхронизации . Например, если поле больше не существует, поставщик вернет соответствующее значение status для объекта Field , например adFieldDoesNotExist. Возвращаемые значения состояния можно логически объединить в значение свойства Status .

Применимо к

Коллекция полей (ADO)

объекта набора записей

См. также

Пример метода resync (VB)
Пример метода resync (VC++)
Метод Clear (ADO)
Свойство UnderlyingValue