Метод SyncSessionContext.OnProgressChanged

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

Пространство имен: 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
)

Параметры

Замечания

Этот метод позволяет сообщать приложению о ходе выполнения пользовательского процесса. Когда поставщик вызывает этот метод, вызывается событие 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

  • Last updated on