Spazio dei nomi Microsoft.Synchronization.Files

  • Articolo

Il provider di sincronizzazione dei file è un componente di Sync Framework che consente a un'applicazione di sincronizzare 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.

L'elemento centrale del servizio è FileSyncProvider. Poiché implementa KnowledgeSyncProvider, per eseguire la sincronizzazione è sufficiente creare, inizializzare e passare il provider di sincronizzazione dei file a 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.

Il provider di sincronizzazione dei file 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 un provider di sincronizzazione, vedere Sincronizzazione di file.

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.

Interfacce

  Interfaccia Descrizione
Public interface IFileDataRetriever Rappresenta il meccanismo mediante il quale avviene il reciproco trasferimento dei dati tra un provider di sincronizzazione dei file e un provider personalizzato.

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.