Classe FileSyncScopeFilter

Définit les filtres qui peuvent être utilisés pour inclure ou exclure des fichiers et des dossiers de l'étendue de la synchronisation statique.

Espace de noms: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (dans microsoft.synchronization.files.dll)

Syntaxe

'Déclaration
Public Class FileSyncScopeFilter
'Utilisation
Dim instance As FileSyncScopeFilter

public class FileSyncScopeFilter

public ref class FileSyncScopeFilter

public class FileSyncScopeFilter

public class FileSyncScopeFilter

Notes

Les filtres statiques sont évalués lors de la détection de modifications et sont également appliqués à tous les éléments dans l'étendue de la synchronisation. Pour qu'un élément soit inclus dans la synchronisation, il doit passer tous les filtres statiques. Par exemple, si un fichier est à la fois explicitement exclu et explicitement inclus, le fichier sera exclu de l'étendue.

Le même filtre d'étendue doit être utilisé sur tous les fournisseurs dans une communauté de synchronisation. Sinon, un comportement indésirable risque de se produire.

Le filtre passé à FileSyncProvider est utilisé pour initialiser l'objet de fournisseur selon le filtre d'étendue qui est passé. Les modifications ultérieures apportées au filtre n'affecteront pas le filtre d'étendue utilisé par cette instance du fournisseur. Pour modifier le filtre d'étendue utilisé, vous devez créer un objet de fournisseur de synchronisation de fichiers.

Le fait de modifier l'étendue d'un réplica après que la première synchronisation peut provoquer des effets secondaires involontaires. Par exemple, supposons que quelque temps après la première synchronisation vous modifiez l'étendue sur le réplica A pour commencer à exclure * .txt. Tous les fichiers qui ont une extension .txt seront alors traités par le réplica A comme étant supprimés. Aucun fichier ne sera supprimé réellement du réplica A. Cependant, les métadonnées pour A contiendront des objets tombstone pour les fichiers .txt, et A enverra des modifications de suppression à d'autres réplicas pour les fichiers .txt. Si vous excluez également * .txt sur le réplica B, l'opération restera sans effet, parce que B filtrera les modifications provenant de A et qui concernent les fichiers .txt. Toutefois, si le réplica B ne change pas son filtre, les fichiers supprimés arriveront jusqu'à lui, pour être traités comme de véritables demandes de modifications et être supprimés du réplica B.

Hiérarchie d'héritage

System.Object
  Microsoft.Synchronization.Files.FileSyncScopeFilter

Sécurité des threads

Tous les membres publics statiques (Partagés en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres FileSyncScopeFilter
Espace de noms Microsoft.Synchronization.Files