Método SyncSessionContext.OnProgressChanged

Artigo
10/17/2009

Relata o progresso da sincronização para o aplicativo.

Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (em microsoft.synchronization.dll)

Sintaxe

'Declaração
Public Sub OnProgressChanged ( _
    e As SyncStagedProgressEventArgs _
)
'Uso
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
)

Parâmetros

e
Um objeto SyncStagedProgressEventArgs que contém os dados do evento.

Comentários

Esse método pode ser usado para relatar o progresso personalizado para o aplicativo. Quando um provedor chama esse método, o evento SyncOrchestrator.SessionProgress é gerado.

Quando ChangeApplication é especificado para a propriedade Stage de e, o Sync Framework acumula o trabalho total concluído que é especificado pela propriedade CompletedWork de e toda vez que OnProgressChanged é chamado. O Sync Framework também interpreta a propriedade TotalWork de e como o trabalho restante para a sessão e calcula o trabalho total para a sessão adicionando TotalWork ao valor acumulado do trabalho concluído. O Sync Framework então passa esses valores calculados para SyncOrchestrator.SessionProgress. Quando a propriedade Stage de e é qualquer outro valor válido, CompletedWork e TotalWork são passados diretamente para SyncOrchestrator.SessionProgress.

Quando o provedor de origem especificar estimativas de trabalho, poderão ocorrer resultados inesperados se um provedor chamar OnProgressChanged e especificar ChangeApplication para a propriedade Stage de e. Isso ocorre porque o Sync Framework calcula o valor do trabalho concluído sempre que são enviadas notificações de progresso durante a aplicação de alterações. Se um provedor enviar sua própria notificação de progresso e especificar ChangeApplication para Stage, o Sync Framework adicionará os valores de estimativa de trabalho especificados pelo provedor ao trabalho total concluído da sessão. Isso pode fazer com que o mesmo trabalho seja contado duas vezes: uma vez quando ele é relatado pelo Sync Framework e uma quando é relatado pelo provedor.

Consulte também

Referência

Classe SyncSessionContext
Membros SyncSessionContext
Namespace Microsoft.Synchronization

Partilhar via