Метод Resync

  • Статья

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

Синтаксис

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

Параметры

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

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

Комментарии

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

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

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

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

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

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

Поля

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

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

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

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

Применение

Коллекция Fields (ADO)

Объект Recordset (ADO)

См. также:

Пример метода Resync (Visual Basic)
Пример метода Resync (Visual C++)
Метод Clear (ADO)
Свойство UnderlyingValue