Share via

Implementieren eines benutzerdefinierten einfachen Anbieters

  • Artikel

Sync Framework bietet APIs an, die von domänenspezifischen (z. B. der Dateisynchronisierungsanbieter) bis zu erweiterbaren Kern-APIs reichen, mit denen die Synchronisierung für jeden Datenspeichertyp aktiviert werden können. Die einfachen Anbieter-APIs liegen in der Mitte dieses Spektrums. Sie bieten Entwicklern einen Großteil der Leistung und Flexibilität von Kern-APIs, jedoch mit weniger Lernaufwand und weniger Code, besonders für Replikate mit wenig bzw. ohne Unterstützung für Änderungsnachverfolgung. Die API für einfache Anbieter ist erweiterbar, sie wurde jedoch in erster Linie für zwei Typen von Replikaten entwickelt:

  • Replikate, die keinerlei Änderungsnachverfolgung unterstützen. Dieser Replikattyp verwendet einen vollständigen Enumerationsanbieter, der bei jeder Synchronisierung alle Elemente des Quellreplikats auflistet.

  • Replikate, die ankerbasierte Änderungsnachverfolgung unterstützen. Dieser Replikattyp verwendet einen ankerbasierten Anbieter. Dieser listet die Elemente des Quellreplikats auf, das sich nach der Festlegung eines bestimmten Ankers geändert hat. Dies ist in der Regel ein Zeitpunkt.

Weitere Informationen zu benutzerdefinierten Anbietern finden Sie unter Grundlegendes zu benutzerdefinierten Anbietern, insbesondere im Abschnitt „Entscheiden zwischen einem einfachen Anbieter und einem Standardanbieter“.

Primäre Schnittstellen und wichtige Optionen

Einfache Anbieterschnittstellen sind in verwaltetem Code und in systemeigenem Code verfügbar. Verwalteter Code befindet sich im Microsoft.Synchronization.SimpleProviders-Namespace in Microsoft.Synchronization.SimpleProviders.dll. Weitere Informationen finden Sie unter Microsoft.Synchronization.SimpleProviders. Systemeigener Code befindet sich in providerframework.dll und erfordert anchorenumerationprovider.h und fullenumerationprovider.h. Weitere Informationen finden Sie unter Sync Framework-Komponenten für einfache Anbieter.

Folgende primäre Schnittstellen sind für einfache Anbieter vorhanden:

Verwaltete Schnittstellen Nicht verwaltete Schnittstellen

FullEnumerationSimpleSyncProvider

IFullEnumerationSyncProvider-Schnittstelle

AnchorEnumerationSimpleSyncProvider

IAnchorSyncProvider-Schnittstelle

FullEnumerationContext

IFullEnumerationCallback-Schnittstelle

AnchorEnumerationContext

IAnchorChangeDetectionCallback-Schnittstelle

ItemEnumerationContext

 

Die Anbieterschnittstellen werden vom Entwickler implementiert. Anbietermethoden, z. B. die verwaltete UpdateItem-Methode oder die nicht verwaltete UpdateItem-Methode, werden bei jeder Synchronisierungssitzung von der Sync Framework-Laufzeit aufgerufen, um Änderungen auszuwählen und zu übernehmen. Für jede dieser Methoden müssen Sie eine Implementierung schreiben, die für das Replikat, den Elementspeicher und die Anwendungsanforderungen spezifisch ist. Die Aktualisierungsmethode muss beispielsweise in der Lage sein, eine Aktualisierung im Zieldatenspeicher auszuführen und Geschäftslogik, die Ihre Anwendung für Aktualisierungen erfordert, zu erzwingen oder entsprechend auf diese zu reagieren. Die Kontext- und Rückrufschnittstellen werden von Sync Framework implementiert und bieten eine Möglichkeit, auf den Synchronisierungssitzungskontext zuzugreifen. Zusätzlich zu den primären Schnittstellen enthält die einfache Anbieter-API wichtige Optionen in den folgenden Bereichen:

Weitere Informationen zu Entwurfsüberlegungen beim Erstellen eines einfachen Anbieters finden Sie unter Überlegungen zum Entwurf eines einfachen benutzerdefinierten Anbieters.

Weitere Informationen zum Erstellen eines verwalteten einfachen Anbieters finden Sie unter Vorgehensweise: Erstellen eines verwalteten einfachen Anbieters.

Siehe auch

Verweis

Microsoft.Synchronization.SimpleProviders

Konzepte

Synchronisieren von Datenspeichern mit benutzerdefinierten Anbietern
Neues in Sync Framework 2.0
Sync Framework-Komponenten für einfache Anbieter