Класс FileSyncProvider

Статья
08/18/2010

Представляет собой синхронную службу синхронизации, которая может использоваться для синхронизации файлов, папок и вложенных папок в файловых системах NTFS, FAT или SMB.

Пространство имен: Microsoft.Synchronization.Files
Сборка: Microsoft.Synchronization.Files (в Microsoft.Synchronization.Files.dll)

Синтаксис

'Декларация
Public Class FileSyncProvider _
    Inherits UnmanagedSyncProviderWrapper _
    Implements IDisposable
'Применение
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

Замечания

Для синхронизации всех файлов и подпапок в каталоге передайте идентификатор реплики и имя корневого каталога в FileSyncProvider(Guid, String), а также передайте поставщик объекту SyncAgent, который должен обработать сеанс синхронизации.

По умолчанию метаданные синхронизации хранятся в файле базы данных службы хранилища метаданных в корневом каталоге реплики. Чтобы задать другое расположение и имя этого файла, укажите их при вызове метода FileSyncProvider(Guid, String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String).

Контроль над тем, какие файлы и папки должны быть включены в область синхронизации, может быть осуществлен путем настройки FileSyncScopeFilter и передачи этого объекта в конструктор поставщика. Фильтр содержит свойства, которые могут использоваться для исключения списка файлов, исключения списка папок, исключения файлов и папок на основании их атрибутов, и явного включения списка файлов.

Для управления поведением службы во время синхронизации может применяться целый ряд параметров конфигурации, FileSyncOptions, которые, например, указывают, происходит ли перемещение удаленных файлов в корзину или их удаление из файловой системы на постоянной основе.

Если в приложении в течение сеанса необходимо обеспечить отображение хода выполнения или динамический пропуск конкретных изменений, то для этого можно использовать различные события.

Эта поставщик может быть переведен в режим предварительного просмотра путем присваивания параметру PreviewMode значения true до начала синхронизации. Работая в режиме предварительного просмотра, поставщик выполняет все действия так, как если бы происходил реальный сеанс синхронизации, включая активизацию всех событий. Однако фактически никакие изменения к реплике назначения не применяются.

Примечание

Параллельная синхронизация одного и того же хранилища файлов не поддерживаются. Если ранее был инициализирован другой экземпляр поставщика с той же репликой (т.е. с теми же значениями пути к каталогу и пути к файлу метаданных), но этот экземпляр еще не был освобожден, то конструктор активизирует исключение ReplicaMetadataInUseException из хранилища метаданных.