FileSyncScopeFilter 类

定义可用于包括或排除静态同步作用域中的文件或文件夹的筛选器。

命名空间: Microsoft.Synchronization.Files
程序集: Microsoft.Synchronization.Files(在 microsoft.synchronization.files.dll 中)

语法

声明
Public Class FileSyncScopeFilter
用法
Dim instance As FileSyncScopeFilter
public class FileSyncScopeFilter
public ref class FileSyncScopeFilter
public class FileSyncScopeFilter
public class FileSyncScopeFilter

备注

静态筛选器应用于变更检测,对同步作用域中的所有项都适用。对于要包括在同步中的项,它必须传递所有静态筛选器。例如,如果某个文件同时被显式排除和显式包括,则该文件将从作用域中排除。

应该对同步社区中的所有提供程序都使用同一个作用域筛选器,否则可能会发生意外行为。

传递给 FileSyncProvider 的筛选器用于在传入时根据作用域筛选器初始化提供程序对象。该筛选器的后续变更将不影响提供程序实例所使用的作用域筛选器。若要变更所使用的作用域筛选器,必须创建新的文件同步提供程序对象。

在首次同步后变更副本作用域可能会导致意外的副作用。例如,假设在首次同步后的某个时候将副本 A 的作用域变更为开始排除 *.txt。这将导致副本 A 将具有 .txt 扩展名的所有文件视为删除。实际上将不会从副本 A 中删除任何文件。但是,副本 A 中的元数据将包含 .txt 文件的逻辑删除,并且副本 A 将把删除变更发送给 .txt 文件的其他副本。如果在副本 B 中也排除 *.txt,则不起作用,因为副本 B 将从属于 .txt 文件的副本 A 中筛选变更。但是,如果副本 B 不变更其筛选器,则已删除的文件将流向它,被视为真正的变更请求,并从副本 B 中删除。

继承层次结构

System.Object
  Microsoft.Synchronization.Files.FileSyncScopeFilter

线程安全

此类型的所有公共静态(在 Visual Basic 中共享 )成员都是线程安全的。不保证任何实例成员的线程安全。

请参阅

参考

FileSyncScopeFilter 成员
Microsoft.Synchronization.Files 命名空间