Compartilhar via


Classe ChangeApplicationServices

Representa um objeto de serviço de aplicação de alteração que pode ser usado para executar ações de aplicação de alteração individualmente.

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

Sintaxe

'Declaração
Public Class ChangeApplicationServices
'Uso
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
public class ChangeApplicationServices
public class ChangeApplicationServices

Comentários

O objeto ChangeApplicationServices faz parte do serviço de aplicação de alteração do Sync Framework, que é usado quando um provedor exige maior flexibilidade do que o permitido pelo aplicador de alteração padrão fornecido pelo Sync Framework. Por exemplo, um provedor deve adiar a aplicação de determinadas alterações para o fim da sessão de sincronização. O aplicador de alteração padrão não permite isso. O provedor pode usar o serviço de aplicação de alteração para manipular a detecção de conflitos e o cálculo de conhecimento, ao mesmo tempo em que mantém a capacidade de adiar as alterações conforme a necessidade.

Para um provedor que não precisa da flexibilidade adicional do serviço de aplicação de alteração, pode ser mais simples usar um aplicador de alteração padrão, como o NotifyingChangeApplier.

O serviço de aplicação de alteração, geralmente, é usado por um provedor de destino para ajudar na implementação de seus métodos ProcessChangeBatch e ProcessFullEnumerationChangeBatch. Para usar o serviço de aplicação de alteração, siga as etapas a seguir:

  1. Crie e inicialize um novo objeto ChangeApplicationServices.

  2. Inicie o processamento de um lote de alterações chamando BeginChangeApplication ou inicie o processamento de um lote de alterações de sincronização de recuperação chamando BeginFullEnumerationChangeApplication. Geralmente, esse método é chamado uma vez para cada lote de alterações a ser processado.

  3. Enumere as alterações no lote de alterações. Chame GetChangeApplicationContext uma vez para cada alteração e use o objeto ChangeApplicationContext retornado para aplicar a alteração.

  4. Relate as alterações cujas aplicações obtiverem êxito, chamando ReportItemChangeApplied ou ReportChangeUnitChangeApplied. Relate as alterações cujas aplicações falharem, chamando ReportRecoverableErrorOnItemChange ou ReportRecoverableErrorOnChangeUnitChange.

  5. Chame GetUpdatedDestinationKnowledge a qualquer momento para recuperar o conhecimento de destino atualizado que contém todas as alterações que foram aplicadas até o momento.

  6. Encerre o processamento de um lote de alterações chamando EndChangeApplication ou encerre o processamento de um lote de alterações de sincronização de recuperação chamando EndFullEnumerationChangeApplication. Salve os objetos de conhecimento de destino atualizado e de conhecimento esquecido de destino que são retornados por esse método.

  7. Repita as etapas de 3 a 7 para cada lote de alterações recebido pelo provedor de destino.

Hierarquia de herança

System.Object
  Microsoft.Synchronization.ChangeApplicationServices

Segurança de thread

Qualquer membro estático público (Compartilhado no Visual Basic) deste tipo é protegido por thread. Não há garantia de que qualquer membro de instância esteja protegido por thread.

Consulte também

Referência

Membros ChangeApplicationServices
Namespace Microsoft.Synchronization