FileSyncProvider Clase
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.
Espacio de nombres: Microsoft.Synchronization.Files
Ensamblado: Microsoft.Synchronization.Files (en Microsoft.Synchronization.Files.dll)
Sintaxis
'Declaración
Public Class FileSyncProvider _
Inherits UnmanagedSyncProviderWrapper _
Implements IDisposable
'Uso
Dim instance As FileSyncProvider
public class FileSyncProvider : UnmanagedSyncProviderWrapper,
IDisposable
public ref class FileSyncProvider : public UnmanagedSyncProviderWrapper,
IDisposable
type FileSyncProvider =
class
inherit UnmanagedSyncProviderWrapper
interface IDisposable
end
public class FileSyncProvider extends UnmanagedSyncProviderWrapper implements IDisposable
Notas
Para sincronizar todos los archivos y subcarpetas de un directorio, pase el identificador de réplica y el directorio raíz a FileSyncProvider(Guid, String) y pase el proveedor a un objeto SyncAgent para controlar la sesión de sincronización.
De forma predeterminada, los metadatos de sincronización se almacenan en un archivo de base de datos de Metadata Storage Service en el directorio raíz de la réplica. Para personalizar la ubicación y el nombre de este archivo, especifíquelos mediante FileSyncProvider(Guid, String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String).
Para controlar qué archivos y carpetas se incluyen en el ámbito de sincronización puede configurar un FileSyncScopeFilter y pasárselo al constructor del proveedor. El filtro contiene propiedades que se pueden usar para excluir una lista de archivos, una lista de carpetas, o archivos y carpetas basándose en sus atributos, así como para incluir explícitamente una lista de archivos.
Existen diversas opciones de configuración, FileSyncOptions, que permiten controlar el comportamiento del proveedor durante la sincronización; por ejemplo, si mueve los archivos eliminados a la papelera de reciclaje o los elimina del sistema de archivos de forma permanente.
Si una aplicación desea mostrar el progreso u omitir dinámicamente determinados cambios durante la sesión, dispone de diversos eventos para ello.
Para activar el modo de vista previa para el proveedor, basta con establecer PreviewMode en true antes de iniciar la sincronización. Mientras esté activado el modo de vista previa, el proveedor realizará todas las acciones como si se estuviera produciendo una sesión de sincronización real, incluso desencadenará todos los eventos. Sin embargo, el proveedor en realidad no aplicará ningún cambio a la réplica de destino.
Nota
No se admiten las operaciones de sincronización simultáneas con el mismo almacén de archivos. Si previamente se inicializó otra instancia del proveedor con la misma réplica (es decir, con los mismos valores para la ruta de acceso del directorio y la ruta de acceso del archivo de metadatos), pero no se ha liberado todavía, el constructor producirá una excepción ReplicaMetadataInUseException procedente del almacén de metadatos.
Jerarquía de herencia
System. . :: . .Object
Microsoft.Synchronization. . :: . .SyncProvider
Microsoft.Synchronization. . :: . .KnowledgeSyncProvider
Microsoft.Synchronization. . :: . .UnmanagedSyncProviderWrapper
Microsoft.Synchronization.Files..::..FileSyncProvider
Seguridad para subprocesos
Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.