ChangeApplicationServices-Klasse
Stellt ein Änderungsanwendungs-Dienstobjekt dar, mit dem Änderungsübernahmeaktionen einzeln ausgeführt werden können.
Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)
Syntax
'Declaration
Public Class ChangeApplicationServices
'Usage
Dim instance As ChangeApplicationServices
public class ChangeApplicationServices
public ref class ChangeApplicationServices
public class ChangeApplicationServices
public class ChangeApplicationServices
Hinweise
Das ChangeApplicationServices-Objekt ist Teil des Änderungsübernahmediensts von Sync Framework, der verwendet wird, wenn ein Anbieter größere Flexibilität als diejenige benötigt, die durch den von Sync Framework bereitgestellten Standardänderungsanwender zugelassen wird. Beispielsweise muss ein Anbieter die Übernahme bestimmter Änderungen bis zum Ende der Synchronisierungssitzung aufschieben. Der Standardänderungsanwender lässt dies nicht zu. Der Anbieter kann Konflikterkennung und Wissensberechnung mithilfe des Änderungsübernahmediensts behandeln, während Änderungen weiterhin wie erforderlich verschoben werden können.
Für einen Anbieter, der die zusätzliche Flexibilität des Änderungsübernahmediensts nicht benötigt, kann es günstiger sein, einen Standardänderungsanwender zu verwenden, wie z. B. NotifyingChangeApplier.
Der Änderungsübernahmedienst wird in der Regel von einem Zielanbieter verwendet, um das Implementieren der zugehörigen ProcessChangeBatch-Methode und ProcessFullEnumerationChangeBatch-Methode zu unterstützen. Führen Sie die folgenden Schritte durch, um den Änderungsübernahmedienst zu verwenden:
Erstellen und initialisieren Sie ein neues ChangeApplicationServices-Objekt.
Starten Sie die Verarbeitung eines Änderungsbatchs durch Aufrufen von BeginChangeApplication, oder starten Sie die Verarbeitung eines Änderungsbatchs zur Wiederherstellungssynchronisierung durch Aufrufen von BeginFullEnumerationChangeApplication. Normalerweise wird diese Methode einmal für jeden Änderungsbatch zu dessen Verarbeitung aufgerufen.
Zählen Sie die Änderungen im Änderungsbatch auf. Rufen Sie GetChangeApplicationContext einmal für jede Änderung auf, und verwenden Sie das zurückgegebene ChangeApplicationContext-Objekt, um die Änderung zu übernehmen.
Melden Sie Änderungen als erfolgreich angewendet, indem Sie ReportItemChangeApplied oder ReportChangeUnitChangeApplied aufrufen. Melden Sie das Anwenden von Änderungen als fehlgeschlagen, indem Sie ReportRecoverableErrorOnItemChange oder ReportRecoverableErrorOnChangeUnitChange aufrufen.
Rufen Sie zu einem beliebigen Zeitpunkt GetUpdatedDestinationKnowledge auf, um das aktualisierte Zielwissen mit allen Änderungen abzurufen, die bis dahin übernommen wurden.
Beenden Sie die Verarbeitung eines Änderungsbatchs durch Aufrufen von EndChangeApplication, oder beenden Sie die Verarbeitung eines Änderungsbatchs zur Wiederherstellungssynchronisierung durch Aufrufen von EndFullEnumerationChangeApplication. Speichern Sie das aktualisierte Zielwissen und vergessene Zielwissensobjekte, die von dieser Methode zurückgegeben werden.
Wiederholen Sie Schritt 3 bis 7 für jeden vom Zielanbieter empfangenen Änderungsbatch.
Vererbungshierarchie
System.Object
Microsoft.Synchronization.ChangeApplicationServices
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Siehe auch
Verweis
ChangeApplicationServices-Member
Microsoft.Synchronization-Namespace