FileSyncProvider 类

是同步的同步提供程序，它可用于同步 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

若要同步目录中的所有文件和子文件夹，请将副本 ID 和根目录传递到 FileSyncProvider(Guid, String)，并将该提供程序传递到 SyncAgent 对象以处理同步会话。

默认情况下，同步元数据存储在副本根目录下的元数据存储服务数据库文件中。若要自定义此文件的位置和名称，请使用 FileSyncProvider(Guid, String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String) 进行指定。

通过配置 FileSyncScopeFilter 并将它传递到提供程序的构造函数可控制哪些文件和文件夹包括在同步作用域内。该筛选器包含一些属性，这些属性可用于排除文件列表，排除文件夹列表以及基于文件和文件夹的属性排除这些文件和文件夹，还可用于显式包括文件列表。

FileSyncOptions 是一组配置选项，可用于在同步期间控制提供程序的行为方式；例如，将已删除的文件移至回收站，或从文件系统中永久删除它们。

会话期间，应用程序可利用多个事件来显示进度或动态跳过特定变更。

同步开始前，通过将 PreviewMode 设置为 true 可将提供程序设置为预览模式。在预览模式下，提供程序将如同进行真正的同步会话一样执行所有操作，包括激发所有事件。但是，提供程序实际上没有将任何变更应用于目标副本。

备注

不支持对同一文件存储区执行并发同步操作。如果此前已经使用同一副本（即相同的目录路径值和元数据文件路径值）对另一个提供程序实例进行了初始化，但尚未释放，则构造函数将从元数据存储区引发 ReplicaMetadataInUseException。

此类型的所有公共成员static（在 Visual Basic 中为 Shared）都是线程安全的。不保证所有实例成员都是线程安全的。