Метод KnowledgeSyncProvider.GetChangeBatch

Статья
09/18/2009

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

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

Синтаксис

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

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge, changeDataRetriever)

public abstract ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge,
    out Object changeDataRetriever
)

public:
virtual ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

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

Параметры

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

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

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

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

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

Замечания

Одно и то же изменение не может появляться в нескольких пакетах.

Если число оставшихся изменений меньше, чем задано параметром batchSize, возвращается меньший пакет изменений.

Если этот метод вызывается при отсутствии оставшихся изменений, возникает исключение InvalidOperationException.

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

См. также

Справочник

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

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