Microsoft.Synchronization.Files-Namespace

Der Dateisynchronisierungsanbieter ist eine Komponente von Sync Framework, mit deren Hilfe eine Anwendung Dateien, Ordner und Unterordner in NTFS-, FAT- oder SMB-Dateisysteme synchronisieren kann. Die zu synchronisierenden Verzeichnisse können lokal vorliegen oder in einem Netzwerk verteilt sein und müssen nicht im gleichen Dateisystem gespeichert sein. Mit statischen Filtern können Dateien ein- oder ausgeschlossen werden. Dazu werden sie explizit aufgelistet, oder es werden Platzhalterzeichen wie *.txt verwendet; es können auch Filter festgelegt werden, die einzelne Unterordner ausschließen. Statusberichte können abgerufen werden, indem die Zustellung von Benachrichtigungen während der Synchronisierung registriert wird.

Das Kernstück des Diensts ist FileSyncProvider. Da er KnowledgeSyncProvider implementiert, muss der Dateisynchronisierungsanbieter nur erstellt, initialisiert und einem SyncAgent übergeben werden, um eine Synchronisierung durchzuführen.

Ein statischer Filter wird durch FileSyncScopeFilter dargestellt und kann verwendet werden, um genauer zu kontrollieren, welche Dateien oder Ordner in die Synchronisierung einbezogen werden sollen.

Verschiedene Ereignisse sind über den Dateisynchronisierungsanbieter verfügbar, darunter AppliedChange und CopyingFile. Für eine Anwendung kann die Zustellung von Benachrichtigungen von jedem dieser Ereignisse registriert werden. Damit kann die Anwendung dem Benutzer den Status der Synchronisierung anzeigen oder andere Aktionen ausführen.

Der Dateisynchronisierungsanbieter speichert mithilfe des Metadaten-Speicherdiensts alle Synchronisierungsmetadaten in einer vereinfachten Datenbank. Die Metadaten-Datenbank ist eine einzelne Datei. Diese Datei kann zusammen mit den zu synchronisierenden Dateien und Ordnern oder an einem anderen Speicherort gespeichert werden, der bei der Initialisierung des Anbieters angegeben wird. Weitere Informationen finden Sie unter Der Metadatenspeicherdienst von Sync Framework.

Weitere Informationen zum Verwenden des Synchronisierungsanbieters finden Sie unter Synchronisieren von Dateien.

Klassen

	Klasse	Beschreibung
	AppliedChangeEventArgs	Stellt Daten für das AppliedChange-Ereignis bereit.
	ApplyingChangeEventArgs	Stellt Daten für das ApplyingChange-Ereignis bereit.
	CopyingFileEventArgs	Stellt Daten für das CopyingFile-Ereignis bereit.
	DetectedChangesEventArgs	Stellt Daten für das DetectedChanges-Ereignis bereit.
	DetectingChangesEventArgs	Stellt Daten für das DetectingChanges-Ereignis bereit.
	FileData	Stellt Informationen über eine Datei oder ein Verzeichnis dar. Dies ist ein loser Wrapper der WIN32_FIND_DATA-Struktur, die zusätzliche Pfadinformationen enthält.
	FileSyncInvalidOperationException	Die Ausnahme, die ausgelöst wird, wenn ein Methodenaufruf ungültig für den aktuellen Objektstatus ist.
	FileSyncProvider	Ein synchroner Synchronisierungsanbieter, der zum Synchronisieren von Dateien, Ordnern und Unterordnern in NTFS-, FAT- und SMB-Dateisystemen verwendet werden kann.
	FileSyncScopeFilter	Definiert Filter, mit denen Dateien und Ordner im statischen Synchronisierungsbereich ein- oder ausgeschlossen werden können.
	SkippedChangeEventArgs	Stellt Daten für das SkippedChange-Ereignis bereit.
	SkippedFileDetectEventArgs	Stellt Daten für das SkippedFileDetect-Ereignis bereit.

Schnittstellen

	Schnittstelle	Beschreibung
	IFileDataRetriever	Stellt den Mechanismus dar, mit dem ein Dateisynchronisierungsanbieter und ein benutzerdefinierter Anbieter Daten untereinander austauschen.

Enumerationen

	Enumeration	Beschreibung
	ChangeType	Stellt die verschiedenen Typen von Änderungen dar, die für ein Zielreplikat übernommen werden können.
	FileSyncOptions	Stellt Optionen bereit, um das Verhalten des Dateisynchronisierungsanbieters zu konfigurieren.
	SkipReason	Stellt die Ursache dar, wegen der eine Datei bei der Änderungserkennung oder dem Ändern einer Anwendung übersprungen wird.