Metodo SyncSessionContext.OnProgressChanged

Articolo
09/18/2009

Segnala lo stato di avanzamento della sincronizzazione all'applicazione.

Spazio dei nomi: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)

Sintassi

'Dichiarazione
Public Sub OnProgressChanged ( _
    e As SyncStagedProgressEventArgs _
)
'Utilizzo
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
)

Parametri

e
Oggetto SyncStagedProgressEventArgs che contiene i dati dell'evento.

Osservazioni

È possibile utilizzare questo metodo per segnalare lo stato di avanzamento personalizzato all'applicazione. Quando un provider chiama tale metodo, viene generato l'evento SyncOrchestrator.SessionProgress.

Quando si specifica ChangeApplication per la proprietà Stage di e, Sync Framework accumula il lavoro totale completato specificato dalla proprietà CompletedWork di e ogni volta che si chiama OnProgressChanged. Sync Framework interpreta inoltre la proprietà TotalWork di e come lavoro rimanente per la sessione e calcola il lavoro totale per la sessione aggiungendo TotalWork al valore accumulato per il lavoro completato. Sync Framework quindi passa tali valori calcolati a SyncOrchestrator.SessionProgress. Quando la proprietà Stage di e è un altro valore valido, CompletedWork e TotalWork vengono passate direttamente a SyncOrchestrator.SessionProgress.

Quando il provider di origine specifica le stime di lavoro, si potrebbero ottenere risultati imprevisti se un provider chiama OnProgressChanged e specifica ChangeApplication per la proprietà Stage di e. Questo avviene in quanto Sync Framework somma il valore relativo al lavoro completato ogni volta che vengono inviate notifiche dello stato di avanzamento durante l'applicazione delle modifiche. Se un provider invia la propria notifica dello stato di avanzamento e specifica ChangeApplication per Stage, Sync Framework aggiunge i valori relativi al lavoro stimato specificati dal provider al lavoro totale completato per la sessione. È pertanto possibile che lo stesso lavoro venga calcolato due volte, ovvero una volta quando viene segnalato da Sync Framework e un'altra quando viene segnalato dal provider.

Vedere anche

Riferimento

Classe SyncSessionContext
Membri SyncSessionContext
Spazio dei nomi Microsoft.Synchronization

Condividi tramite