ChangeApplicationServices Clase

Representa un objeto de servicio de aplicación de cambios que se puede utilizar para realizar las acciones de aplicación de cambios de una en una.

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

Sintaxis

'Declaración
Public Class ChangeApplicationServices
'Uso
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
type ChangeApplicationServices =  class end
public class ChangeApplicationServices

Notas

El objeto ChangeApplicationServices forma parte del servicio de aplicación de cambios de Sync Framework, que se utiliza cuando un proveedor requiere mayor flexibilidad que la permitida por el aplicador de cambios estándar proporcionado por Sync Framework. Por ejemplo, un proveedor debe retrasar la aplicación de ciertos cambios al final de la sesión de sincronización. El aplicador de cambios estándar no lo permite. El proveedor puede utilizar el servicio de aplicación de cambios para controlar la detección de conflictos y el cálculo del conocimiento, a la vez que conserva la capacidad de retrasar los cambios según sea necesario.

En el caso de un proveedor que no necesite la flexibilidad adicional del servicio de aplicación de cambios, puede ser más fácil utilizar un aplicador de cambios estándar, como NotifyingChangeApplier.

Normalmente, los proveedores de destino utilizan el servicio de aplicación de cambios para ayudar a implementar los métodos ProcessFullEnumerationChangeBatch y ProcessChangeBatch. Para utilizar el servicio de aplicación de cambios, siga estos pasos:

  1. Cree e inicialice un nuevo objeto ChangeApplicationServices.

  2. Inicie el procesamiento de un lote de cambios llamando a BeginChangeApplication o inicie el procesamiento de un lote de cambios de sincronización de recuperación llamando a BeginFullEnumerationChangeApplication. Normalmente, se llama a este método una vez para cada lote de cambios que se va a procesar.

  3. Enumere los cambios del lote de cambios. Llame a GetChangeApplicationContext una vez para cada cambio y utilice el objeto ChangeApplicationContext devuelto para aplicar el cambio.

  4. Notifique los cambios aplicados correctamente llamando al método ReportItemChangeApplied o al método ReportChangeUnitChangeApplied. Notifique los cambios que no se han aplicado llamando al método ReportRecoverableErrorOnItemChange o al método ReportRecoverableErrorOnChangeUnitChange.

  5. Llame al método GetUpdatedDestinationKnowledge en cualquier momento para recuperar el conocimiento de destino actualizado que contiene todos los cambios aplicados hasta ese momento.

  6. Finalice el procesamiento de un lote de cambios llamando a EndChangeApplication o finalice el procesamiento de un lote de cambios de sincronización de recuperación llamando a EndFullEnumerationChangeApplication. Guarde los objetos de conocimiento de destino actualizado y de conocimiento olvidado de destino devueltos por este método.

  7. Repita los pasos 3 a 7 para cada lote de cambios recibido por el proveedor de destino.

Jerarquía de herencia

System. . :: . .Object
  Microsoft.Synchronization..::..ChangeApplicationServices

Seguridad para subprocesos

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

ChangeApplicationServices Miembros

Microsoft.Synchronization Espacio de nombres