Classe FileSyncProvider
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).
Per stabilire quali file e cartelle devono essere inclusi nell'ambito della sincronizzazione è possibile configurare un oggetto FileSyncScopeFilter e passarlo al costruttore del provider. Il filtro contiene proprietà che possono essere utilizzate per escludere un elenco di file, un elenco di cartelle oppure 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
Le operazioni di sincronizzazione simultanee non sono supportate 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. I membri di istanza non hanno garanzia di essere thread safe.
Vedere anche
Riferimento
Membri FileSyncProvider
Spazio dei nomi Microsoft.Synchronization.Files