Класс 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, используется для инициализации объекта поставщика на основе фильтра области при его передаче. Последующие изменения в фильтре не затрагивают фильтр области, который используется этим экземпляром поставщика. Чтобы изменить используемый фильтр области, необходимо создать новый объект службы синхронизации файлов.

Смена области реплики после первой синхронизации может вызвать нежелательные побочные эффекты. Предположим, спустя какое-то время после первой синхронизации область реплики А перенастроена на исключение TXT-файлов. Это приведет к тому, что все файлы, имеющие расширение TXT, будут рассматриваться в реплике А как удаленные. Фактического удаления файлов из реплики А не произойдет, однако метаданные для реплики А будут содержать для TXT-файлов отметки полного удаления, поэтому реплика А будет передавать другим репликам изменения для удаления TXT-файлов. Если исключить TXT-файлы также и в реплике Б, это не вызовет никаких последствий, поскольку реплика Б будет фильтровать поступающие от реплики А изменения, которые относятся к TXT-файлам. Но если фильтр в реплике Б останется прежним, то к ней поступят изменения, касающиеся удаления файлов, которые будут рассматриваться как действительные запросы на изменение, в результате чего произойдет удаление файлов из реплики Б.

Иерархия наследования

System.Object
  Microsoft.Synchronization.Files.FileSyncScopeFilter

Многопоточное использование

Все общие статические члены (Shared в Visual Basic) можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Элементы FileSyncScopeFilter
Пространство имен Microsoft.Synchronization.Files