FileSyncProvider 類別

這是同步的同步處理提供者，可用來同步處理 NTFS、FAT 或 SMB 檔案系統中的檔案、資料夾和子資料夾。

命名空間： Microsoft.Synchronization.Files
組件： Microsoft.Synchronization.Files (在 Microsoft.Synchronization.Files.dll 中)

語法

'宣告
Public Class FileSyncProvider _
    Inherits UnmanagedSyncProviderWrapper _
    Implements IDisposable
'用途
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

若要同步處理目錄中的所有檔案和子資料夾，請將複寫識別碼和根目錄傳遞給 FileSyncProvider(Guid, String)，並將提供者傳遞給 SyncAgent 物件來處理同步處理工作階段。

根據預設，同步處理中繼資料是儲存在複寫根目錄的中繼資料儲存服務資料庫檔案中。若要自訂這個檔案的位置和名稱，請使用 FileSyncProvider(Guid, String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String) 來指定這些項目。

對於哪些檔案和資料夾包含在同步處理範圍內的控制，可藉由設定 FileSyncScopeFilter 並將它傳遞給提供者的建構函式來完成。篩選包含了可用來排除檔案清單、排除資料夾清單、排除檔案和資料夾 (根據其屬性 (Attribute)) 及明確包含檔案清單的屬性 (Property)。

有一些組態選項 FileSyncOptions 可用來控制同步處理期間的提供者行為，例如，它是否會將已刪除的檔案移到資源回收筒，或是從檔案系統中永久刪除。

有提供各種事件給工作階段期間想要顯示進度或是動態跳過特定變更的應用程式使用。

可以在開始同步處理之前將 PreviewMode 設定為 true，將提供者置於預覽模式。當提供者在預覽模式時，將會執行所有的動作，就像是真正的同步處理工作階段正在發生一樣，包括引發所有事件。但是，提供者實際上不會將任何變更套用到目的地複寫。

注意

不支援對相同的檔案存放區進行並行的同步處理作業。如果之前有另一個提供者執行個體已經使用相同的複寫初始化 (也就是目錄路徑和中繼資料檔案路徑的相同值)，但是尚未釋放，則此建構函式將會從中繼資料存放區擲回 ReplicaMetadataInUseException。

這個類型的任何公用static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員都可以是安全執行緒。