Classe 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.

Espace de noms: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (dans microsoft.synchronization.files.dll)

Syntaxe

'Déclaration
Public Class FileSyncProvider
    Inherits UnmanagedSyncProviderWrapper
    Implements IDisposable
'Utilisation
Dim instance As FileSyncProvider

public class FileSyncProvider : UnmanagedSyncProviderWrapper, IDisposable

public ref class FileSyncProvider : public UnmanagedSyncProviderWrapper, IDisposable

public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable

public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable

Notes

Pour synchroniser tous les fichiers et sous-dossiers dans un répertoire, passez l'ID de réplica et le répertoire racine à FileSyncProvider(Guid,String) et passez le fournisseur à un objet SyncAgent pour gérer la session de synchronisation.

Par défaut, les métadonnées de synchronisation sont stockées dans un fichier de base de données du Metadata Storage Service, dans le répertoire racine du réplica. Pour personnaliser l'emplacement et le nom de ce fichier, spécifiez-les en utilisant FileSyncProvider(Guid,String,FileSyncScopeFilter,FileSyncOptions,String,String,String,String).

Pour pouvoir déterminer les fichiers et dossiers qui sont inclus dans l'étendue de la synchronisation, vous devez configurer un objet FileSyncScopeFilter et le passer au constructeur du fournisseur. Le filtre contient des propriétés qui peuvent être utilisées pour exclure une liste de fichiers, exclure une liste de dossiers, exclure des fichiers et dossiers sur la base de leurs attributs, et inclure explicitement une liste de fichiers.

Plusieurs options de configuration, FileSyncOptions, sont disponibles pour contrôler comment le fournisseur se comporte pendant la synchronisation, par exemple, s'il déplace les fichiers supprimés vers la Corbeille ou les supprime définitivement du système de fichiers.

Divers événements sont disponibles pour l'application qui souhaite afficher la progression ou dynamiquement ignorer des modifications particulières pendant la session.

Le fournisseur peut être mis en mode Aperçu en effectuant à PreviewMode la valeur true avant de démarrer la synchronisation. En mode Aperçu, le fournisseur effectue toutes les actions comme dans une session de synchronisation réelle, y compris le déclenchement de tous les événements. Toutefois, le fournisseur n'applique pas réellement les modifications au réplica de destination.

Notes

Les opérations de synchronisation simultanées au même magasin de fichiers ne sont pas prises en charge. Si une autre instance du fournisseur a été initialisée précédemment avec le même réplica (autrement dit, les mêmes valeurs pour le chemin d'accès au répertoire et chemin d'accès de fichier de métadonnées), mais n'a pas encore été libéré, le constructeur lèvera une ReplicaMetadataInUseException à partir du magasin des métadonnées.

Hiérarchie d'héritage

System.Object
   Microsoft.Synchronization.SyncProvider
     Microsoft.Synchronization.KnowledgeSyncProvider
       Microsoft.Synchronization.UnmanagedSyncProviderWrapper
        Microsoft.Synchronization.Files.FileSyncProvider

Sécurité des threads

Tous les membres publics statiques (Partagés en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres FileSyncProvider
Espace de noms Microsoft.Synchronization.Files