Пространство имен Microsoft.Synchronization.Files

Служба синхронизации файлов является компонентом платформы Sync Framework, который помогает приложению синхронизировать файлы, папки и вложенные папки в файловых системах NTFS, FAT и SMB. Каталоги, подлежащие синхронизации, могут быть локальными или удаленными, и не обязаны находиться в одной и той же файловой системе. Исключение или включение файлов с помощью их явного перечисления или с использованием символов-шаблонов, таких как *.txt, может осуществляться с использованием статических фильтров; могут быть также заданы фильтры, которые исключают отдельные подпапки. Отчеты о состоянии могут быть получены путем регистрации для получения уведомлений во время синхронизации.

Центром этого сервиса является FileSyncProvider. Поскольку служба синхронизации файлов реализует метод KnowledgeSyncProvider, для проведения синхронизации его достаточно создать, инициализировать и передать объекту SyncAgent.

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

Службе синхронизации файлов доступно несколько событий, таких как AppliedChange и CopyingFile. В приложении может быть выполнена регистрация для получения уведомлений о любом из этих событий. Это позволяет в приложении показывать ход выполнения синхронизации пользователю или предпринимать некоторые другие действия.

Служба синхронизации файлов хранит все метаданные синхронизации в упрощенной базе данных службы хранилища метаданных. База данных метаданных расположена в одном файле. Этот файл может храниться с файлами и папками, предназначенными для синхронизации, или в другом местоположении, которое указывается при инициализации поставщика. Дополнительные сведения см. в разделе Служба хранилища метаданных платформы Sync Framework.

Дополнительные сведения об использовании службы синхронизации файлов см. в разделе Синхронизация файлов.

Классы

  Класс Описание
Public class AppliedChangeEventArgs Предоставляет данные для события AppliedChange.
Public class ApplyingChangeEventArgs Предоставляет данные для события ApplyingChange.
Public class CopyingFileEventArgs Предоставляет данные для события CopyingFile.
Public class DetectedChangesEventArgs Предоставляет данные для события DetectedChanges.
Public class DetectingChangesEventArgs Предоставляет данные для события DetectingChanges.
Public class FileData Представляет информацию о файле или каталоге. Это произвольно заданная оболочка структуры WIN32_FIND_DATA, которая содержит дополнительную информацию пути.
Public class FileSyncInvalidOperationException Исключение, которое возникает, если вызов метода недопустим при текущем состоянии объекта.
Public class FileSyncProvider Представляет собой синхронную службу синхронизации, которая может использоваться для синхронизации файлов, папок и вложенных папок в файловых системах NTFS, FAT или SMB.
Public class FileSyncScopeFilter Определяет фильтры, которые могут использоваться для включения или исключения файлов и папок из статической области синхронизации.
Public class SkippedChangeEventArgs Предоставляет данные для события SkippedChange.
Public class SkippedFileDetectEventArgs Предоставляет данные для события SkippedFileDetect.

Интерфейсы

  Интерфейс Описание
Public interface IFileDataRetriever Представляет механизм, при помощи которого служба синхронизации файлов и пользовательский поставщик обмениваются данными друг с другом.

Перечисления

  Перечисление Описание
Public enumeration ChangeType Представляет различные типы изменений, которые могут быть применены к реплике назначения.
Public enumeration FileSyncOptions Предоставляет параметры для настройки работы службы синхронизации файлов.
Public enumeration SkipReason Представляет причину, по которой файл был пропущен в ходе обнаружения изменений или применения изменений.