Classe ChangeApplicationServices
Représente un objet de service d'application de modifications qui peut être utilisé pour effectuer individuellement des actions d'application de modifications.
Espace de noms : Microsoft.Synchronization
Assembly : Microsoft.Synchronization (dans Microsoft.Synchronization.dll)
Syntaxe
'Déclaration
Public Class ChangeApplicationServices
'Utilisation
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
type ChangeApplicationServices = class end
public class ChangeApplicationServices
Notes
L'objet ChangeApplicationServices fait partie du service d'application de modifications de Sync Framework, utilisé lorsqu'un fournisseur requiert une plus grande souplesse que celle autorisée par l'applicateur de modifications standard fourni par Sync Framework. Par exemple, un fournisseur doit différer l'application de certaines modifications à la fin de la session de synchronisation. L'applicateur de modifications standard ne le permet pas. Le fournisseur peut utiliser le service d'application de modifications pour gérer la détection de conflit et le calcul de connaissance tout en conservant la possibilité de différer des modifications, si nécessaire.
Pour un fournisseur qui n'a pas besoin de la souplesse supplémentaire du service d'application de modifications, il peut être plus simple d'utiliser un applicateur de modifications standard, tel que NotifyingChangeApplier.
Le service d'application de modifications est généralement utilisé par un fournisseur de destination pour permettre l'implémentation des méthodes ProcessChangeBatch et ProcessFullEnumerationChangeBatch. Pour utiliser le service d'application de modifications, procédez comme suit :
Créez et initialisez un nouvel objet ChangeApplicationServices.
Appelez la méthode BeginChangeApplication pour commencer le traitement d'un lot de modifications, ou appelez la méthode BeginFullEnumerationChangeApplication pour commencer le traitement d'un lot de modifications d'une synchronisation de récupération. Cette méthode est généralement appelée une fois pour chaque lot de modifications à traiter.
Énumérez les modifications dans le lot de modifications. Appelez la méthode GetChangeApplicationContext une fois pour chaque modification et utilisez l'objet ChangeApplicationContext retourné pour appliquer la modification.
Appelez ReportItemChangeApplied ou ReportChangeUnitChangeApplied pour signaler que l'application des modifications a réussi. Appelez la méthode ReportRecoverableErrorOnItemChange ou ReportRecoverableErrorOnChangeUnitChange pour signaler que l'application des modifications a échoué.
Appelez GetUpdatedDestinationKnowledge à tout moment pour récupérer la connaissance de destination mise à jour qui contient toutes les modifications appliquées jusqu'à présent.
Appelez la méthode EndChangeApplication pour mettre fin au traitement d'un lot de modifications, ou appelez la méthode EndFullEnumerationChangeApplication pour mettre fin au traitement d'un lot de modifications d'une synchronisation de récupération. Enregistrez la connaissance de destination mise à jour et les objets de connaissance oubliée de destination qui sont retournés par cette méthode.
Répétez les étapes 3 à 7 pour chaque lot de modifications reçu par le fournisseur de destination.
Hiérarchie d'héritage
System. . :: . .Object
Microsoft.Synchronization..::..ChangeApplicationServices
Sécurité des threads
Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.