Compartilhar via


Namespace Microsoft.Synchronization.Files

O provedor de sincronização de arquivos é um componente do Sync Framework que ajuda um aplicativo a sincronizar arquivos, pastas e subpastas em sistemas de arquivos NTFS, FAT ou SMB. Os diretórios para sincronização podem ser locais ou remotos e não precisam estar no mesmo sistema de arquivos. Podem ser usados filtros estáticos para excluir ou incluir arquivos, listando-os explicitamente ou usando curingas, como * .txt, ou podem ser definidos filtros para excluir subpastas individuais. Os relatórios de andamento podem ser obtidos mediante registro para receber notificações durante a sincronização.

A parte mais importante do serviço é FileSyncProvider. Pelo fato de implementar o KnowledgeSyncProvider, o provedor de sincronização de arquivos só precisa ser criado, inicializado e transmitido para um SyncAgent a fim de executar a sincronização.

Um filtro estático é representado por FileSyncScopeFilter e pode ser usado para controle refinado dos arquivos ou das pastas que participam da sincronização.

Vários eventos estão disponíveis do provedor de sincronização de arquivos, como AppliedChange e CopyingFile. Um aplicativo pode registrar-se para receber notificações de quaisquer desses eventos. Isso permite que o aplicativo mostre o progresso da sincronização ao usuário ou execute alguma outra ação.

O provedor de sincronização de arquivos usa o serviço de armazenamento de metadados para armazenar todos os metadados de sincronização em um banco de dados leve. O banco de dados de metadados é um único arquivo. Esse arquivo pode ser armazenado com arquivos e pastas que serão sincronizados ou em outro local especificado durante a inicialização do provedor. Para obter mais informações, consulte Sync Framework Metadata Storage Service.

Para obter mais informações sobre como usar o provedor de sincronização de arquivos, consulte Sincronizando arquivos.

Classes

  Classe Descrição
Public class AppliedChangeEventArgs Fornece dados para o evento AppliedChange.
Public class ApplyingChangeEventArgs Fornece dados para o evento ApplyingChange.
Public class CopyingFileEventArgs Fornece dados para o evento CopyingFile.
Public class DetectedChangesEventArgs Fornece dados para o evento DetectedChanges.
Public class DetectingChangesEventArgs Fornece dados para o evento DetectingChanges.
Public class FileData Representa informações sobre um arquivo ou diretório. Este é um wrapper flexível da estrutura WIN32_FIND_DATA que contém informações adicionais do caminho.
Public class FileSyncInvalidOperationException A exceção que é lançada quando a chamada de um método é inválida para o estado atual do objeto.
Public class FileSyncProvider É um provedor de sincronização síncrono que pode ser usado para sincronizar arquivos, pastas e subpastas em sistemas de arquivos NTFS, FAT ou SMB.
Public class FileSyncScopeFilter Define filtros que podem ser usados para incluir ou excluir arquivos e pastas do escopo de sincronização estático.
Public class SkippedChangeEventArgs Fornece dados para o evento SkippedChange.
Public class SkippedFileDetectEventArgs Fornece dados para o evento SkippedFileDetect.

Interfaces

  Interface Descrição
Public interface IFileDataRetriever Representa o mecanismo pelo qual um provedor de sincronização de arquivos e um provedor personalizado transferem dados entre si.

Enumerações

  Enumeração Descrição
Public enumeration ChangeType Representa os tipos diferentes de alterações que podem ser aplicadas a uma réplica de destino.
Public enumeration FileSyncOptions Fornece opções para configurar o comportamento do provedor de sincronização de arquivos.
Public enumeration SkipReason Representa a razão pela qual um arquivo foi ignorado durante a detecção ou aplicação de alterações.