Microsoft.Synchronization.Files Espacio de nombres

  • Artículo

El proveedor de sincronización de archivos es un componente de Sync Framework que ayuda a una aplicación a sincronizar archivos, carpetas y subcarpetas en los sistemas de archivos NTFS, FAT o SMB. Los directorios que se sincronizan pueden ser locales o remotos, y no es necesario que estén en el mismo sistema de archivos. Se pueden usar filtros estáticos para excluir o incluir archivos, bien sea incluyéndolos de forma explícita en una lista o bien mediante caracteres comodín, como * .txt; también pueden configurarse filtros para excluir subcarpetas específicas. Se pueden obtener informes de progreso registrándose para recibir notificaciones durante la sincronización.

El núcleo del servicio es FileSyncProvider. Dado que implementa KnowledgeSyncProvider, sólo es necesario crear, inicializar y pasar el proveedor de sincronización de archivos a SyncAgent para realizar la sincronización.

Un filtro estático se representa mediante FileSyncScopeFilter y puede usarse para controlar con más precisión qué archivos o carpetas participan en la sincronización.

El proveedor de sincronización de archivos proporciona varios eventos, como AppliedChange y CopyingFile. Se puede registrar una aplicación para que reciba notificaciones de cualquiera de estos eventos. Esto permite a la aplicación mostrar el progreso de sincronización al usuario o llevar a cabo alguna otra acción.

El proveedor de sincronización de archivos usa Metadata Storage Service para almacenar todos los metadatos de sincronización en una base de datos ligera. La base de datos de metadatos es un solo archivo. Este archivo puede estar almacenado con los archivos y carpetas que se van a sincronizar o en otra ubicación que se especifica al inicializar el proveedor. Para obtener más información, vea Sync Framework Metadata Storage Service.

Para obtener más información acerca de cómo utilizar el proveedor de sincronización de archivos, vea Sincronizar archivos.

Clases

  Clase Descripción
Public class AppliedChangeEventArgs Proporciona datos para el evento AppliedChange.
Public class ApplyingChangeEventArgs Proporciona datos para el evento ApplyingChange.
Public class CopyingFileEventArgs Proporciona datos para el evento CopyingFile.
Public class DetectedChangesEventArgs Proporciona datos para el evento DetectedChanges.
Public class DetectingChangesEventArgs Proporciona datos para el evento DetectingChanges.
Public class FileData Representa información sobre un archivo o un directorio. Éste es un contenedor separado de la estructura WIN32_FIND_DATA que contiene la información de la ruta de acceso adicional.
Public class FileSyncInvalidOperationException Excepción que se produce cuando la llamada a un método no es válida para el estado actual del objeto.
Public class FileSyncProvider Es un proveedor de sincronización sincrónica que se puede usar para sincronizar archivos, carpetas y subcarpetas en sistemas de archivos NTFS, FAT o SMB.
Public class FileSyncScopeFilter Define filtros que se pueden usar para incluir o excluir archivos y carpetas del ámbito de sincronización estática.
Public class SkippedChangeEventArgs Proporciona datos para el evento SkippedChange.
Public class SkippedFileDetectEventArgs Proporciona datos para el evento SkippedFileDetect.

Interfaces

  Interfaz Descripción
Public interface IFileDataRetriever Representa el mecanismo por el que un proveedor de sincronización de archivos y un proveedor personalizado intercambian datos.

Enumeraciones

  Enumeración Descripción
Public enumeration ChangeType Representa los distintos tipos de cambios que se pueden aplicar a una réplica de destino.
Public enumeration FileSyncOptions Proporciona opciones para configurar el comportamiento del proveedor de sincronización de archivos.
Public enumeration SkipReason Representa el motivo por el que un archivo se omitió durante la detección o la aplicación de cambios.