Microsoft.Synchronization.Files Espacio de nombres

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
	AppliedChangeEventArgs	Proporciona datos para el evento AppliedChange.
	ApplyingChangeEventArgs	Proporciona datos para el evento ApplyingChange.
	CopyingFileEventArgs	Proporciona datos para el evento CopyingFile.
	DetectedChangesEventArgs	Proporciona datos para el evento DetectedChanges.
	DetectingChangesEventArgs	Proporciona datos para el evento DetectingChanges.
	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.
	FileSyncInvalidOperationException	Excepción que se produce cuando la llamada a un método no es válida para el estado actual del objeto.
	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.
	FileSyncScopeFilter	Define filtros que se pueden usar para incluir o excluir archivos y carpetas del ámbito de sincronización estática.
	SkippedChangeEventArgs	Proporciona datos para el evento SkippedChange.
	SkippedFileDetectEventArgs	Proporciona datos para el evento SkippedFileDetect.

Interfaces

	Interfaz	Descripción
	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
	ChangeType	Representa los distintos tipos de cambios que se pueden aplicar a una réplica de destino.
	FileSyncOptions	Proporciona opciones para configurar el comportamiento del proveedor de sincronización de archivos.
	SkipReason	Representa el motivo por el que un archivo se omitió durante la detección o la aplicación de cambios.