Classe FileSyncProvider

Artigo
10/17/2009

É 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.

Namespace: Microsoft.Synchronization.Files
Assembly: Microsoft.Synchronization.Files (em microsoft.synchronization.files.dll)

Sintaxe

'Declaração
Public Class FileSyncProvider
    Inherits UnmanagedSyncProviderWrapper
    Implements IDisposable
'Uso
Dim instance As FileSyncProvider

public class FileSyncProvider : UnmanagedSyncProviderWrapper, IDisposable

public ref class FileSyncProvider : public UnmanagedSyncProviderWrapper, IDisposable

public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable

public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable

Comentários

Para sincronizar todos os arquivos e subpastas em um diretório, passe a ID da réplica e o diretório raiz para FileSyncProvider(Guid,String) e passe o provedor para um objeto SyncAgent para manipular a sessão de sincronização.

Por padrão, os metadados da sincronização são armazenados em um arquivo de banco de dados do serviço de armazenamento de metadados no diretório raiz da réplica. Para personalizar o local e o nome desse arquivo, especifique esses itens usando FileSyncProvider(Guid,String,FileSyncScopeFilter,FileSyncOptions,String,String,String,String).

Controle de quais arquivos e pastas são incluídos no escopo de sincronização pode ser realizado configurando um FileSyncScopeFilter e passando-o ao construtor do provedor. O filtro contém propriedades que podem ser usadas para excluir uma lista de arquivos, lista de pastas, arquivos e pastas com base nos seus atributos e incluir, explicitamente, uma lista de arquivos.

Várias opções de configuração, FileSyncOptions, estão disponíveis para controlar como o provedor se comporta durante a sincronização; por exemplo, se move arquivos excluídos para a lixeira ou os exclui permanentemente do sistema de arquivos.

Há diversos eventos disponíveis para o aplicativo que quer exibir o andamento ou ignorar, dinamicamente, alterações específicas durante a sessão.

O provedor pode ser colocado no modo de visualização, definindo PreviewMode como true antes de iniciar a sincronização. No modo de visualização, o provedor executará todas as ações como se uma sessão de sincronização real estivesse acontecendo, inclusive disparando todos os eventos. Porém, o provedor não aplicará nenhuma alteração à réplica de destino.

Dica

Não há suporte para operações de sincronização simultâneas para o mesmo repositório de arquivo. Se outra instância do provedor tiver sido inicializada anteriormente com a mesma réplica (quer dizer, os mesmos valores para caminho de diretório e caminho de arquivo de metadados), mas não tiver sido liberada ainda, o construtor lançará um ReplicaMetadataInUseException a partir do repositório de metadados.

Hierarquia de herança

System.Object
   Microsoft.Synchronization.SyncProvider
     Microsoft.Synchronization.KnowledgeSyncProvider
       Microsoft.Synchronization.UnmanagedSyncProviderWrapper
        Microsoft.Synchronization.Files.FileSyncProvider

Segurança de thread

Qualquer membro estático público (Compartilhado no Visual Basic) deste tipo é protegido por thread. Não há garantia de que qualquer membro de instância esteja protegido por thread.

Consulte também

Referência

Membros FileSyncProvider
Namespace Microsoft.Synchronization.Files

Compartilhar via