Метод resync (ADO)
Область применения: Access 2013, Office 2013
Обновляет данные в текущем объекте Recordset или коллекции Fields объекта Record из базовой базы данных.
Синтаксис
Набор записей. ResyncAffectRecords, ResyncValues
Запись. Поля. Повторнаясинхронизация значений
Параметры
| Параметр | Описание |
|---|---|
| AffectRecords | Необязательный параметр. Значение AffectEnum , определяющее, на сколько записей повлияет метод Resync . Значение по умолчанию — adAffectAll. Это значение недоступно в методе Resync коллекции Fields объекта Record . |
| ResyncValues | Необязательный параметр. Значение ResyncEnum , указывающее, перезаписываются ли базовые значения. Значение по умолчанию — adResyncAllValues. |
Замечания
Recordset
Используйте метод Resync для повторной синхронизации записей в текущем наборе записей с базовой базой данных. Это полезно, если вы используете статический или переадресующий курсор, но хотите увидеть любые изменения в базовой базе данных.
Если для свойства CursorLocation задано значение adUseClient, повторная синхронизация будет доступна только для объектов Recordset , не доступных только для чтения.
В отличие от метода Requery , метод Resync не выполняет повторно базовую команду объекта Recordset . Новые записи в базовой базе данных не будут видны.
Если попытка повторной синхронизации завершается ошибкой из-за конфликта с базовыми данными (например, запись была удалена другим пользователем), поставщик возвращает предупреждения в коллекцию Errors и возникает ошибка во время выполнения. Используйте свойство Filter (adFilterConflictingRecords) и свойство Status для поиска записей с конфликтами.
Если заданы динамические свойства Unique Table и Resync Command , а набор записей является результатом выполнения операции JOIN для нескольких таблиц, то метод Resync выполнит команду, указанную в свойстве Resync Command , только для таблицы с именем в свойстве Unique Table .
Fields
Используйте метод Resync для повторной синхронизации значений коллекции Fields объекта Record с базовым источником данных. Этот метод не влияет на свойство Count .
Если параметр ResyncValues имеет значение adResyncAllValues (значение по умолчанию), то свойства UnderlyingValue, Value и OriginalValue объектов Field в коллекции синхронизируются. Если параметр ResyncValues имеет значение adResyncUnderlyingValues, синхронизируется только свойство UnderlyingValue .
Значение свойства Status для каждого объекта Field во время вызова также влияет на поведение resync. Для объектов Field со значениями состоянияadFieldPendingUnknown или adFieldPendingInsertповторная синхронизация не оказывает влияния. Для значений состоянияadFieldPendingChange или adFieldPendingDeleteresync синхронизирует значения данных для полей, которые по-прежнему существуют в источнике данных.
Повторная синхронизация не изменяет значения состояния объектов Field , если при вызове resync не возникнет ошибка. Например, если поле больше не существует, поставщик вернет соответствующее значение Status для объекта Field , например adFieldDoesNotExist. Возвращаемые значения Состояния могут логически объединяться в значение свойства Status .