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

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

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

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

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

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

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

Классы

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

Интерфейсы

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

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

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