SyncSessionContext.OnProgressChanged Método

  • Artículo

Notifica el progreso de la sincronización a la aplicación.

Espacio de nombres: Microsoft.Synchronization
Ensamblado: Microsoft.Synchronization (en microsoft.synchronization.dll)

Sintaxis

'Declaración
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

Notas

Este método se puede usar para notificar el progreso personalizado a la aplicación. Cuando un proveedor llama a este método, se genera el evento SyncOrchestrator.SessionProgress.

Cuando se especifica ChangeApplication para la propiedad Stage de e, Sync Framework acumula el trabajo total completado especificado por la propiedad CompletedWork de e cada vez que se llama a OnProgressChanged. Sync Framework interpreta también la propiedad TotalWork de e como el trabajo que queda en la sesión y calcula el trabajo total de la sesión sumando TotalWork al valor acumulado del trabajo completado. A continuación, Sync Framework pasa estos valores calculados a SyncOrchestrator.SessionProgress. Cuando la propiedad Stage de e es cualquier otro valor válido, CompletedWork y TotalWork se pasan directamente a SyncOrchestrator.SessionProgress.

Cuando el proveedor de origen especifica estimaciones de trabajo, pueden producirse resultados inesperados si un proveedor llama a OnProgressChanged y especifica ChangeApplication para la propiedad Stage de e. Esto se debe a que Sync Framework totaliza el valor del trabajo completado cada vez que se envían notificaciones de progreso durante la aplicación de cambios. Si un proveedor envía su propia notificación de progreso y especifica ChangeApplication para Stage, Sync Framework agrega los valores de trabajo estimado especificados por el proveedor al trabajo completado total para la sesión. Esto puede hacer que el mismo trabajo se cuente dos veces: una cuando lo notifica Sync Framework y otra cuando lo notifica el proveedor.

Vea también

Referencia

SyncSessionContext Clase
SyncSessionContext Miembros
Microsoft.Synchronization Espacio de nombres