Класс FileSyncProvider

Статья
10/17/2009

Представляет собой синхронную службу синхронизации, которая может использоваться для синхронизации файлов, папок и вложенных папок в файловых системах 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

public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable

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 из хранилища метаданных.

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

Иерархия наследования

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

Многопоточное использование

Все общие статические члены (Shared в Visual Basic) можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Элементы FileSyncProvider
Пространство имен Microsoft.Synchronization.Files

Поделиться через