Share via

Spazio dei nomi Microsoft.Synchronization.Files

  • Articolo

Sync Services for File Systems è un componente di Microsoft Sync Framework che implementa un provider di sincronizzazione per supportare le applicazioni nella sincronizzazione di file, cartelle e sottocartelle in file system NTFS, FAT o SMB. Le directory da sincronizzare possono essere locali o remote e non è necessario che appartengano allo stesso file system. È possibile utilizzare filtri statici per escludere o includere file, elencandoli in modo esplicito o tramite caratteri jolly, ad esempio * .txt. In alternativa è possibile impostare filtri per escludere singole sottocartelle. Se si esegue la registrazione per la ricezione di notifiche durante la sincronizzazione, è possibile ottenere report sullo stato di avanzamento.

Il cuore del servizio è FileSyncProvider. Poiché implementa KnowledgeSyncProvider, per eseguire la sincronizzazione è sufficiente creare, inizializzare e passare il provider di sincronizzazione dei file a un oggetto SyncAgent.

Un filtro statico è rappresentato da FileSyncScopeFilter e può essere utilizzato per garantire un controllo più preciso dei file o delle cartelle da includere nella sincronizzazione.

Con il provider di sincronizzazione dei file sono disponibili diversi eventi, ad esempio AppliedChange e CopyingFile. Un'applicazione può eseguire la registrazione per ricevere notifiche da qualsiasi di questi eventi e quindi mostrare lo stato della sincronizzazione all'utente o eseguire un'azione.

Sync Services for File Systems utilizza il servizio di archiviazione dei metadati per archiviare tutti i metadati di sincronizzazione in un database lightweight. Il database dei metadati è un file singolo che può essere archiviato con i file e le cartelle da sincronizzare o in un percorso diverso che viene specificato all'inizializzazione del provider. Per ulteriori informazioni, vedere Servizio di archiviazione dei metadati di Sync Framework.

Per ulteriori informazioni sull'utilizzo di Sync Services for File Systems, vedere Sync Services for File Systems.

Classi

  Classe Descrizione
Public class AppliedChangeEventArgs Fornisce i dati per l'evento AppliedChange.
Public class ApplyingChangeEventArgs Fornisce i dati per l'evento ApplyingChange.
Public class CopyingFileEventArgs Fornisce i dati per l'evento CopyingFile.
Public class DetectedChangesEventArgs Fornisce i dati per l'evento DetectedChanges.
Public class DetectingChangesEventArgs Fornisce i dati per l'evento DetectingChanges.
Public class FileData Rappresenta informazioni su un file o una directory. Si tratta di un wrapper di tipo loose della struttura WIN32_FIND_DATA che contiene informazioni aggiuntive sul percorso.
Public class FileSyncInvalidOperationException Eccezione generata quando una chiamata a un metodo non è valida per lo stato corrente dell'oggetto.
Public class FileSyncProvider Provider di sincronizzazione sincrona che può essere utilizzato per sincronizzare file, cartelle e sottocartelle in file system NTFS, FAT o SMB.
Public class FileSyncScopeFilter Definisce filtri che possono essere utilizzati per includere o escludere file e cartelle dall'ambito di sincronizzazione statico.
Public class SkippedChangeEventArgs Fornisce i dati per l'evento SkippedChange.
Public class SkippedFileDetectEventArgs Fornisce i dati per l'evento SkippedFileDetect.

Enumerazioni

  Enumerazione Descrizione
Public enumeration ChangeType Rappresenta i diversi tipi di modifiche che possono essere applicate a una replica di destinazione.
Public enumeration FileSyncOptions Fornisce opzioni per la configurazione del comportamento del provider di sincronizzazione dei file.
Public enumeration SkipReason Rappresenta il motivo per cui file è stato ignorato durante il rilevamento o l'applicazione delle modifiche.