Classe FileSyncProvider

Articolo
09/27/2010

Provider di sincronizzazione sincrona che può essere utilizzato per sincronizzare file, cartelle e sottocartelle in file system NTFS, FAT o SMB.

Spazio dei nomi: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (in microsoft.synchronization.files.dll)

Sintassi

'Dichiarazione
Public Class FileSyncProvider
    Inherits UnmanagedSyncProviderWrapper
    Implements IDisposable
'Utilizzo
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

Osservazioni

Per sincronizzare tutti i file e le sottocartelle in una directory, passare l'ID replica e la directory radice a FileSyncProvider(Guid,String) e passare il provider a un oggetto SyncAgent per gestire la sessione di sincronizzazione.

Per impostazione predefinita, i metadati di sincronizzazione sono archiviati in un file di database del servizio di archiviazione dei metadati nella directory radice della replica. Per personalizzare il percorso e il nome del file, specificare tali informazioni tramite FileSyncProvider(Guid,String,FileSyncScopeFilter,FileSyncOptions,String,String,String,String).

Il controllo dei file e delle cartelle inclusi nell'ambito della sincronizzazione può essere garantito configurando un oggetto FileSyncScopeFilter e passandolo al costruttore del provider. Il filtro contiene proprietà che possono essere utilizzate per escludere un elenco di file, un elenco di cartelle e file e cartelle in base ad attributi, nonché per includere in modo esplicito un elenco di file.

Sono disponibili diverse opzioni di configurazione, FileSyncOptions, che consentono di controllare il comportamento del provider durante la sincronizzazione, ad esempio se i file eliminati verranno spostati nel cestino o eliminati in modo permanente dal file system.

Per le applicazioni in cui è necessario visualizzare lo stato di avanzamento o ignorare in modo dinamico determinate modifiche durante la sessione è disponibile un'ampia gamma di eventi.

Il provider può essere utilizzato in modalità di anteprima impostando PreviewMode su true prima di avviare la sincronizzazione. In modalità di anteprima il provider eseguirà tutte le azioni di una sessione di sincronizzazione reale, inclusa la generazione di tutti gli eventi, ma non applicherà alcuna modifica alla replica di destinazione.

Nota

Non sono supportate operazioni di sincronizzazione simultanee nello stesso archivio file. Se un'altra istanza del provider è stata inizializzata in precedenza con la stessa replica, ovvero gli stessi valori per percorso di directory e percorso del file dei metadati, ma non è ancora stata rilasciata, il costruttore genererà un'eccezione ReplicaMetadataInUseException dall'archivio dei metadati.

Gerarchia di ereditarietà

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

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Membri FileSyncProvider
Spazio dei nomi Microsoft.Synchronization.Files

Condividi tramite