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
type ChangeApplicationServices = class end
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ções padrão não permite isso. O provedor pode usar o serviço de aplicação de alterações 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:
Crie e inicialize um novo objeto ChangeApplicationServices.
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.
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.
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.
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.
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.
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
Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.