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
type FileSyncProvider =
class
inherit UnmanagedSyncProviderWrapper
interface IDisposable
end
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 service de stockage des métadonnées, 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 static (Shared dans Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.