Partager via


Implémentation d'un fournisseur personnalisé simple

Sync Framework propose divers types d'API, des API spécifiques au domaine, telles que le fournisseur de synchronisation de fichiers, jusqu'aux API principales extensibles qui peuvent activer la synchronisation pour tout type de magasin de données. Les API de fournisseur simple se situent au milieu de cette gamme. Elles offrent aux développeurs quasiment toute la puissance et la flexibilité des API principales, mais nécessitent une durée d'apprentissage plus courte et une utilisation moindre de code, notamment pour les réplicas avec une prise en charge nulle ou minimale du suivi des modifications. L'API de fournisseur simple est extensible, mais elle est principalement conçue pour les deux types de réplicas suivants :

  • Réplicas qui ne prennent en charge aucune sorte de suivi des modifications. Ce type de réplica utilise un fournisseur d'énumération complète, qui énumère tous les éléments du réplica source à chaque synchronisation.

  • Réplicas qui prennent en charge le suivi des modifications par ancrage. Ce type de réplica utilise un fournisseur basé sur les ancres, qui énumère les éléments du réplica source ayant été modifiés après qu'une ancre spécifique a été définie (généralement une limite dans le temps).

Pour plus d'informations sur les fournisseurs personnalisés, consultez Principes de base des fournisseurs personnalisés, en particulier la section « Fournisseur simple ou fournisseur standard ».

Interfaces principales et options importantes

Les interfaces de fournisseur simple sont disponibles en code managé et en code natif. Le code managé se trouve dans l'espace de noms Microsoft.Synchronization.SimpleProviders dans Microsoft.Synchronization.SimpleProviders.dll ; pour plus d'informations, consultez Microsoft.Synchronization.SimpleProviders. Le code natif se trouve dans providerframework.dll et requiert anchorenumerationprovider.h et fullenumerationprovider.h ; pour plus d'informations, consultez Composants de fournisseurs simples de Sync Framework.

Les interfaces principales pour les fournisseurs simples sont les suivantes :

Interfaces managées Interfaces non managées

FullEnumerationSimpleSyncProvider

Interface IFullEnumerationSyncProvider

AnchorEnumerationSimpleSyncProvider

Interface IAnchorSyncProvider

FullEnumerationContext

Interface IFullEnumerationCallback

AnchorEnumerationContext

Interface IAnchorChangeDetectionCallback

ItemEnumerationContext

 

Les interfaces de fournisseur sont implémentées par le développeur. Les méthodes de fournisseur, telles que la méthode UpdateItem managée ou la méthode UpdateItem non managée, sont appelées par le runtime Sync Framework lors de chaque session de synchronisation pour sélectionner et appliquer des modifications. Pour chacune de ces méthodes, vous devez écrire une implémentation appropriée pour le réplica, le magasin d'éléments et les besoins de l'application. Par exemple, la méthode de mise à jour doit être capable d'effectuer une mise à jour dans le magasin de données de destination et d'appliquer ou de répondre convenablement à toute logique métier dont votre application a besoin pour les mises à jour. Les interfaces de rappel et de contexte sont implémentées par Sync Framework et offrent un accès au contexte de session de synchronisation. En plus des interfaces principales, l'API de fournisseur simple inclut des options importantes dans les domaines suivants :

Pour plus d'informations sur les considérations relatives à la conception lorsque vous créez un fournisseur simple, consultez Considérations sur la conception de fournisseur personnalisé simple.

Pour plus d'informations sur la création d'un fournisseur simple managé, consultez Procédure : créer un fournisseur simple managé.

Voir aussi

Référence

Microsoft.Synchronization.SimpleProviders

Concepts

Synchronisation de magasins de données à l'aide de fournisseurs personnalisés
Nouveautés dans Sync Framework 2.0
Composants de fournisseurs simples de Sync Framework