Espace de noms Microsoft.Synchronization.Files

Le fournisseur de synchronisation de fichiers est un composant de Sync Framework qui aide une application à synchroniser les fichiers, les dossiers et les sous-dossiers dans les systèmes de fichiers NTFS, FAT ou SMB. Les répertoires à synchroniser peuvent être locaux ou distants et ne doivent nécessairement être du même système de fichiers. Des filtres statiques peuvent être utilisés pour exclure ou inclure des fichiers en les répertoriant explicitement ou en utilisant des caractères génériques, comme * .txt ; il est aussi possible de définir des filtres de façon à exclure des sous-dossier particuliers. Des rapports d'avancement peuvent être obtenus en s'inscrivant pour recevoir des notifications pendant la synchronisation.

L'élément central du service est FileSyncProvider. Dans la mesure où il implémente KnowledgeSyncProvider, le fournisseur de synchronisation de fichiers doit seulement être créé, initialisé et passé à un SyncAgent pour effectuer la synchronisation.

Un filtre statique est représenté par FileSyncScopeFilter et peut être utilisé pour un contrôle plus fin permettant de déterminer les fichiers ou dossiers qui participent à la synchronisation.

Plusieurs événements sont disponibles auprès du fournisseur de synchronisation de fichiers, tels que AppliedChange et CopyingFile. Une application peut s'inscrire pour recevoir des notifications de chacun de ces événements. Cela permet à l'application de montrer la progression de synchronisation à l'utilisateur ou d'entreprendre quelque autre action.

Le fournisseur de synchronisation de fichiers utilise le service de stockage des métadonnées pour stocker toutes les métadonnées de synchronisation dans une base de données légère. La base de données de métadonnées est un fichier unique. Ce fichier peut être stocké avec les fichiers et dossiers à synchroniser ou à un autre emplacement spécifié quand le fournisseur est initialisé. Pour plus d'informations, consultez Metadata Storage Service de Sync Framework.

Pour plus d'informations sur l'utilisation du fournisseur de synchronisation de fichiers, consultez Synchronisation des fichiers.

Classes

	Classe	Description
	AppliedChangeEventArgs	Fournit des données pour l'événement AppliedChange.
	ApplyingChangeEventArgs	Fournit des données pour l'événement ApplyingChange.
	CopyingFileEventArgs	Fournit des données pour l'événement CopyingFile.
	DetectedChangesEventArgs	Fournit des données pour l'événement DetectedChanges.
	DetectingChangesEventArgs	Fournit des données pour l'événement DetectingChanges.
	FileData	Représente des informations relatives à un fichier ou un répertoire. C'est un wrapper faible de la structure WIN32_FIND_DATA qui contient des informations supplémentaires relatives au chemin d'accès.
	FileSyncInvalidOperationException	Exception qui est levée lorsqu'un appel de méthode n'est pas valide pour l'état actuel de l'objet.
	FileSyncProvider	Il s'agit d'un fournisseur de synchronisation synchrone qui peut être utilisé pour synchroniser des fichiers, des dossiers et des sous-dossiers dans les systèmes de fichiers NTFS, FAT ou SMB.
	FileSyncScopeFilter	Définit les filtres qui peuvent être utilisés pour inclure ou exclure des fichiers et des dossiers de l'étendue de la synchronisation statique.
	SkippedChangeEventArgs	Fournit des données pour l'événement SkippedChange.
	SkippedFileDetectEventArgs	Fournit des données pour l'événement SkippedFileDetect.

Interfaces

	Interface	Description
	IFileDataRetriever	Représente le mécanisme grâce auquel un fournisseur de synchronisation de fichiers et un fournisseur personnalisé transfèrent des données entre eux.

Énumérations

	Énumération	Description
	ChangeType	Représente les différents types des modifications qui peuvent s'appliquer à un réplica de destination.
	FileSyncOptions	Fournit des options pour configurer le comportement du fournisseur de synchronisation de fichiers.
	SkipReason	Indique la raison pour laquelle un fichier a été ignoré pendant la détection de modifications ou l'application de modifications.