Метод ResyncResync Method

Обновляет данные в текущем объекте набора записей или коллекции полей объекта записи из базовой базы данных.Refreshes the data in the current Recordset object, or Fields collection of a Record object, from the underlying database.

СинтаксисSyntax

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

ПараметрыParameters

аффектрекордсAffectRecords
Необязательный элемент.Optional. Значение аффектенум , определяющее количество записей, на которые будет влиять метод повторной синхронизации .An AffectEnum value that determines how many records the Resync method will affect. Значение по умолчанию — адаффекталл.The default value is adAffectAll. Это значение недоступно в методе Resync коллекции Fields объекта Record .This value is not available with the Resync method of the Fields collection of a Record object.

ресинквалуесResyncValues
Необязательный элемент.Optional. Значение ресинценум , указывающее, перезаписываются ли базовые значения.A ResyncEnum value that specifies whether underlying values are overwritten. Значение по умолчанию — адресинкаллвалуес.The default value is adResyncAllValues.

RemarksRemarks

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

Используйте метод Resync для повторной синхронизации записей в текущем наборе записей с базовой базой данных.Use the Resync method to resynchronize 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.

Если для свойства CursorLocation задано значение адусеклиент, Повторная синхронизация доступна только для объектов Recordset , не являющихся доступными только для чтения.If you set the CursorLocation property to adUseClient, Resync is only available for non-read-only Recordset objects.

В отличие от метода Resync , метод Resync не выполняет повторное выполнение базовой команды объекта Recordset .Unlike the Requery 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 and a run-time error occurs. Используйте свойство Filter (адфилтерконфликтингрекордс) и свойство Status для обнаружения записей с конфликтами.Use the Filter property (adFilterConflictingRecords) and the Status property to locate records with conflicts.

Если заданы динамические свойства уникальной таблицы и повторной синхронизации , а набор записей является результатом выполнения операции объединения нескольких таблиц, то метод Resync выполняет команду, указанную в свойстве Command повторной синхронизации , только для таблицы, указанной в свойстве уникальной таблицы .If the Unique Table and Resync Command dynamic properties are set, and the Recordset is the result of executing a JOIN operation on multiple tables, then the Resync method will execute the command given in the Resync Command property only on the table named in the Unique Table property.

ПоляFields

Используйте метод Resync для повторной синхронизации значений коллекции Fields объекта Record с базовым источником данных.Use the Resync method to resynchronize the values of the Fields collection of a Record object with the underlying data source. Этот метод не влияет на свойство Count .The Count property is not affected by this method.

Если для ресинквалуес задано значение адресинкаллвалуес (по умолчанию), то свойства UnderlyingValue, valueи originalValue объектов field в коллекции синхронизируются.If ResyncValues is set to adResyncAllValues (the default value), the UnderlyingValue, Value, and OriginalValue properties of Field objects in the collection are synchronized. Если для ресинквалуес задано значение адресинкундерлингвалуес, то синхронизируется только свойство UnderlyingValue .If ResyncValues is set to adResyncUnderlyingValues, only the UnderlyingValue property is synchronized.

Значение свойства Status для каждого объекта поля во время вызова также влияет на поведение повторной синхронизации.The value of the Status property for each Field object at the time of the call also affects the behavior of Resync. Для объектов Field , имеющих значения состояния адфиелдпендингункновн или адфиелдпендингинсерт, Повторная синхронизация не действует.For Field objects that have Status values of adFieldPendingUnknown or adFieldPendingInsert, Resync has no effect. Для значений состояния адфиелдпендингчанже или адфиелдпендингделетеповторная Синхронизация синхронизирует значения данных для полей, которые еще существуют в источнике данных.For Status values of adFieldPendingChange or adFieldPendingDelete, Resync synchronizes data values for fields that still exist at the data source.

Повторная синхронизация не приведет к изменению значений состояния объектов полей , если не возникает ошибка при вызове повторной синхронизации .Resync will not modify Status values of Field objects unless an error occurs when Resync is called. Например, если поле больше не существует, поставщик возвратит соответствующее значение состояния для объекта поля , например адфиелддоеснотексист.For example, if the field no longer exists, the provider will return an appropriate Status value for the Field object, such as adFieldDoesNotExist. Возвращаемые значения состояния могут быть логически объединены в значение свойства Status .Returned Status values can be logically combined within the value of the Status property.

ПрименениеApplies To

См. такжеSee Also

Пример метода Resync (Visual Basic) Resync Method Example (VB)
Пример метода Resync (Visual c++) Resync Method Example (VC++)
Метод Clear (ADO) Clear Method (ADO)
Свойство UnderlyingValueUnderlyingValue Property