Метод SyncSessionContext.OnProgressChanged

Статья
09/18/2009

Сообщает приложению о ходе выполнения синхронизации.

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

Синтаксис

'Декларация
Public Sub OnProgressChanged ( _
    e As SyncStagedProgressEventArgs _
)
'Применение
Dim instance As SyncSessionContext
Dim e As SyncStagedProgressEventArgs

instance.OnProgressChanged(e)

public void OnProgressChanged (
    SyncStagedProgressEventArgs e
)

public:
void OnProgressChanged (
    SyncStagedProgressEventArgs^ e
)

public void OnProgressChanged (
    SyncStagedProgressEventArgs e
)

public function OnProgressChanged (
    e : SyncStagedProgressEventArgs
)

Параметры

e
Объект SyncStagedProgressEventArgs, содержащий данные события.

Замечания

Этот метод может быть использован для сообщения приложению о ходе выполнения пользовательского процесса. Когда поставщик вызывает этот метод, вызывается событие SyncOrchestrator.SessionProgress.

Если для свойства Stage параметра e указывается значение ChangeApplication, то Sync Framework накапливает общий объем завершенной работы, который указывается свойством CompletedWork параметра e каждый раз, когда вызывается метод OnProgressChanged. Sync Framework также интерпретирует свойство TotalWork параметра e как объем оставшейся работы для сеанса и вычисляет общий объем работы для сеанса, добавляя TotalWork к накопленному значению объема завершенной работы. Затем Sync Framework передает эти вычисленные значения методу SyncOrchestrator.SessionProgress. Если свойство Stage параметра e является любым другим допустимым значением, то CompletedWork и TotalWork напрямую передаются методу SyncOrchestrator.SessionProgress.

Когда поставщик источника указывает предполагаемые объемы работы, могут возникнуть непредвиденные результаты, если поставщик вызывает метод OnProgressChanged и указывает значение ChangeApplication для свойства Stage параметра e. Это обусловлено тем, что Sync Framework суммирует значения объема завершенной работы каждый раз, когда уведомления о ходе выполнения передаются во время изменения приложения. Если поставщик отправляет собственное уведомление о ходе выполнения и указывает ChangeApplication для Stage, Sync Framework добавляет предполагаемые значения объема работы, указанные поставщиком для общего объема завершенной работы для сеанса. Это может привести к тому, что один и тот же объем работы будет учтен дважды: один раз при передаче Sync Framework и один раз — при передаче поставщиком.

См. также

Справочник

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

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