Метод KnowledgeSyncProvider.GetFullEnumerationChangeBatch

Статья
09/18/2009

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

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

Синтаксис

'Декларация
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    knowledgeForDataRetrieval As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'Применение
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim knowledgeForDataRetrieval As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, knowledgeForDataRetrieval, changeDataRetriever)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge knowledgeForDataRetrieval,
    out Object changeDataRetriever
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ knowledgeForDataRetrieval, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge knowledgeForDataRetrieval, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

JScript does not support passing value-type arguments by reference.

Параметры

batchSize
Число изменений, включаемых в пакет.

lowerEnumerationBound
Нижняя граница для значений идентификаторов элементов. Этот метод возвращает изменения, значение идентификатора которых больше или равно заданному.

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

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

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

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

Замечания

Этот метод вызывается Sync Framework в процессе восстановления утраченного набора знаний.

Этот метод перечисляет (в порядке возрастания значений идентификаторов элементов) изменения, значение идентификатора которых равное параметру lowerEnumerationBound или больше него. Это позволяет Sync Framework определить, какие из элементов поставщика назначения были удалены, но утрачены поставщиком источника. При необходимости этот метод добавляет в пакет, отсортированный по идентификаторам элементов, изменения с теми идентификаторами элементов, которые меньше значения lowerEnumerationBound и не содержатся в наборе знаний назначения.

Примечания по реализации. Если после этого пакета не осталось изменений для отправки, в возвращаемом пакете изменений необходимо установить для параметра IsLastBatch значение TRUE. В противном случае Sync Framework снова вызовет метод GetFullEnumerationChangeBatch, чтобы получить следующий пакет изменений. Для поставщика, отправляющего данные элемента вместе с метаданными изменения элемента, параметр knowledgeForDataRetrieval может использоваться для определения того, требуется ли отправлять данные элемента. Если изменения элемента содержатся в наборе knowledgeForDataRetrieval, то данные элемента отправлять не нужно.

См. также

Справочник

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

Основные понятия

Восстановление устаревшей реплики

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