Implementando um provedor personalizado simples
O Sync Framework oferece APIs que variam de específicas do domínio, como o provedor de sincronização de arquivos, às APIs de núcleo abertas que habilitam a sincronização de qualquer tipo de repositório de dados. As APIs de provedor simples estão no meio desse espectro. Elas oferecem aos desenvolvedores a sofisticação e a flexibilidade das APIs de núcleo, mas com uma curva de aprendizagem melhor e menos código, especialmente para réplicas que têm pouco ou nenhum suporte ao controle de alterações. A API de provedor simples é extensível, mas foi criada principalmente para dois tipos de réplicas:
Réplicas que não dão suporte a qualquer tipo de controle de alterações. Esse tipo de réplica usa um provedor de enumeração completa que enumera todos os itens da réplica de origem sempre que a sincronização ocorre.
Réplicas que dão suporte ao controle de alterações baseado em âncora. Esse tipo de réplica usa um provedor baseado em âncora que enumera os itens da réplica de origem alterados depois que uma âncora específica foi definida, que normalmente é um determinado momento.
Para obter mais informações sobre provedores personalizados, consulte Conceitos básicos sobre provedores personalizados, especialmente a seção "Decidindo entre um provedor simples e um provedor padrão".
Interfaces primárias e opções importantes
As interfaces de provedores simples estão disponíveis em código gerenciado e em código nativo. O código gerenciado se encontra no namespace Microsoft.Synchronization.SimpleProviders em Microsoft.Synchronization.SimpleProviders.dll; para obter mais informações, consulte Microsoft.Synchronization.SimpleProviders. O código nativo se encontra em providerframework.dll e exige anchorenumerationprovider.h e fullenumerationprovider.h; para obter mais informações, consulte Componentes de provedor simples do Sync Framework.
As interfaces primárias para provedores simples são as seguintes:
Interfaces gerenciadas |
Interfaces não gerenciadas |
|---|---|
|
As interfaces de provedor são implementadas pelo desenvolvedor. Os métodos de provedor, como o UpdateItem gerenciado ou o UpdateItem não gerenciado, são chamados pelo tempo de execução do Sync Framework durante cada sessão de sincronização para selecionar e aplicar alterações. Para cada um desses métodos, você deve escrever uma implementação específica para a réplica, o repositório de itens e as necessidades do aplicativo. Por exemplo, o método de atualização deve poder executar uma atualização no repositório de dados de destino e impor ou responder adequadamente a qualquer lógica de negócios que seu aplicativo exija para as atualizações. As interfaces de contexto e de retorno de chamada são implementadas pelo Sync Framework e fornecem um modo de acessar o contexto de sessão de sincronização. Além das interfaces primárias, a API de provedor simples inclui opções importantes nas seguintes áreas:
Gerenciamento de metadados. Para obter mais informações, consulte Gerenciando metadados para provedores simples.
Manipulação de conflitos. Para obter mais informações, consulte Resolvendo conflitos para provedores simples.
Filtragem de dados. Para obter mais informações, consulte Filtrando dados para provedores simples.
Para obter mais informações sobre considerações de design durante a criação de um provedor simples, consulte Considerações para criar um provedor personalizado simples.
Para obter mais informações sobre a criação de um provedor simples gerenciado, consulte Como criar um provedor simples gerenciado.
Consulte também
Referência
Microsoft.Synchronization.SimpleProviders
Outros recursos
Sincronizando repositórios de dados usando provedores personalizados