SyncSessionContext.OnProgressChanged Método

Artículo
09/18/2009

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

e
Objeto SyncStagedProgressEventArgs que contiene los datos del evento.

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 provoca 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 también interpreta la propiedad TotalWork de e como el trabajo restante para la sesión y calcula el trabajo total para la sesión agregando TotalWork al valor acumulado para el trabajo completado. Sync Framework pasa a continuación 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 dar lugar a que el mismo trabajo se contabilice dos veces: una vez cuando es notificado por Sync Framework, y otra vez cuando es notificado por el proveedor.

Vea también

Referencia

SyncSessionContext Clase
SyncSessionContext Miembros
Microsoft.Synchronization Espacio de nombres

Share via