Метод ReplicaMetadata.GetFilteredFullEnumerationLocalVersions

Статья
10/17/2009

При переопределении в производном классе возвращает отфильтрованный пакет изменений, содержащий версии элементов и базовых единиц, которые хранятся в данной реплике и соответствуют элементам и базовым единицам, на которые имелись ссылки в пакете изменений, полученном от другого поставщика как часть полного перечисления.

Пространство имен: Microsoft.Synchronization.MetadataStorage
Сборка: Microsoft.Synchronization.MetadataStorage (в microsoft.synchronization.metadatastorage.dll)

Синтаксис

'Декларация
Public MustOverride Function GetFilteredFullEnumerationLocalVersions ( _
    sourceChanges As FullEnumerationChangeBatch, _
    filterCallback As ItemFilterCallback _
) As IEnumerable(Of ItemChange)
'Применение
Dim instance As ReplicaMetadata
Dim sourceChanges As FullEnumerationChangeBatch
Dim filterCallback As ItemFilterCallback
Dim returnValue As IEnumerable(Of ItemChange)

returnValue = instance.GetFilteredFullEnumerationLocalVersions(sourceChanges, filterCallback)

public abstract IEnumerable<ItemChange> GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch sourceChanges,
    ItemFilterCallback filterCallback
)

public:
virtual IEnumerable<ItemChange^>^ GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch^ sourceChanges, 
    ItemFilterCallback^ filterCallback
) abstract

public abstract IEnumerable<ItemChange> GetFilteredFullEnumerationLocalVersions (
    FullEnumerationChangeBatch sourceChanges, 
    ItemFilterCallback filterCallback
)

public abstract function GetFilteredFullEnumerationLocalVersions (
    sourceChanges : FullEnumerationChangeBatch, 
    filterCallback : ItemFilterCallback
) : IEnumerable<ItemChange>

Параметры

sourceChanges
Пакет изменений, полученный от другого поставщика, который будет применен к хранилищу элементов, связанному с данной репликой.

filterCallback
Делегат, который вызывается для определения необходимости добавления элемента в пакет.

Возвращаемое значение

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

Замечания

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

Значения версий в пакете изменений, возвращаемых этим методом, используются объектами применения изменений для обнаружения конфликтов.

Делегат filterCallback вызывается перед добавлением каждого элемента в пакет. Если делегат вернул значение true, то элемент добавляется в пакет. В противном случае добавление элемента не производится.

Примечания по реализации. Пакет изменений, возвращаемый этим методом, должен содержать по одной записи для каждого элемента, содержащего идентификатор, значение которого находится в диапазоне, верхние границы которого указывают параметр sourceChanges, включая записи базовых единиц, за исключением случаев, когда делегатом filterCallback указано, что запись включать не нужно. Если элемент существует в хранилище и включен фильтром, то его запись должна содержать сведения о версии для этой реплики. Если элемент, включенный в фильтр, не существует, то его версия должна быть установлена в значение SyncVersion.UnknownVersion, а свойство P:Microsoft.Synchronization.ItemChange.ChangeKind — в значение UnknownItem.

См. также

Справочник

Класс ReplicaMetadata
Элементы ReplicaMetadata
Пространство имен Microsoft.Synchronization.MetadataStorage

Поделиться через