Microsoft.Synchronization.Files 命名空间

文件同步提供程序是 Sync Framework 的一个组件，可帮助应用程序同步 NTFS、FAT 或 SMB 文件系统中的文件、文件夹和子文件夹。用于同步的目录可为本地或远程目录，且不必属于相同的文件系统。静态筛选器可通过显式列出文件或使用通配符（如 *.txt）来排除或包括这些文件；或者通过设置筛选器来排除各个子文件夹。通过注册，可以在同步期间接收通知来获取进度报表。

该服务的核心为 FileSyncProvider。因为它可实现 KnowledgeSyncProvider，所以只需创建并初始化文件同步提供程序，并将其传递到 SyncAgent 即可执行同步。

静态筛选器由 FileSyncScopeFilter 表示，可用于更好地控制哪些文件或文件夹参与同步。

文件同步提供程序中包含多个事件，例如 AppliedChange 和 CopyingFile。应用程序可注册为接收来自这些事件中任一事件的通知。这使应用程序可向用户显示同步进度或执行其他操作。

文件同步提供程序使用元数据存储服务在轻型数据库中存储所有同步元数据。元数据数据库是一个文件。此文件可与要同步的文件或文件夹存储在一起，或存储在初始化提供程序时指定的另一个位置。有关更多信息，请参见Sync Framework Metadata Storage Service。

有关如何使用文件同步提供程序的更多信息，请参见同步文件。

类

	类	说明
	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	表示变更检测或变更应用期间跳过文件的原因。