共用方式為

Microsoft.Synchronization.Files 命名空間

  • 發行項

檔案同步處理提供者是 Sync Framework 的元件，可協助應用程式同步處理 NTFS、FAT 或 SMB 檔案系統中的檔案、資料夾和子資料夾。要同步處理的目錄可以是本機或遠端目錄，而且不需要位於相同的檔案系統。靜態篩選可用來排除或包含檔案，其方式是明確列出檔案或使用萬用字元 (如 *.txt)，或者可以設定篩選來排除個別子資料夾。可以透過註冊方式來取得進度報表，以便在同步處理期間接收通知。

此服務的中心部分是 FileSyncProvider。因為它會實作 KnowledgeSyncProvider，所以只需要建立和初始化檔案同步處理提供者，並傳遞給 SyncAgent，便可執行同步處理。

靜態篩選是由 FileSyncScopeFilter 來表示，而且可用來更細微地控制哪些檔案或資料夾會參與同步處理。

檔案同步處理提供者有提供幾個事件，例如 AppliedChange 和 CopyingFile。應用程式可以註冊來接收任何這類事件的通知。如此可讓應用程式顯示同步處理進度給使用者，或採取其他某些動作。

檔案同步處理提供者會使用中繼資料儲存服務，將所有同步處理中繼資料儲存在輕量型資料庫中。中繼資料資料庫是單一檔案，這個檔案可以與要同步處理的檔案和資料夾存放在一起，或是放在初始化提供者時所指定的另一個位置。如需詳細資訊，請參閱Sync Framework Metadata Storage Service。

如需如何使用檔案同步處理提供者的詳細資訊，請參閱同步處理檔案。

類別

  類別 描述
Public class AppliedChangeEventArgs 提供 AppliedChange 事件的資料。
Public class ApplyingChangeEventArgs 提供 ApplyingChange 事件的資料。
Public class CopyingFileEventArgs 提供 CopyingFile 事件的資料。
Public class DetectedChangesEventArgs 提供 DetectedChanges 事件的資料。
Public class DetectingChangesEventArgs 提供 DetectingChanges 事件的資料。
Public class FileData 表示有關檔案或目錄的資訊。這是包含其他路徑資訊之 WIN32_FIND_DATA 結構的寬鬆包裝函式。
Public class FileSyncInvalidOperationException 當方法呼叫不適用於此物件的目前狀態時，所擲回的例外狀況 (Exception)。
Public class FileSyncProvider 這是同步的同步處理提供者，可用來同步處理 NTFS、FAT 或 SMB 檔案系統中的檔案、資料夾和子資料夾。
Public class FileSyncScopeFilter 定義篩選，可用篩選來從靜態同步處理範圍併入或排除檔案和資料夾。
Public class SkippedChangeEventArgs 提供 SkippedChange 事件的資料。
Public class SkippedFileDetectEventArgs 提供 SkippedFileDetect 事件的資料。

介面

  介面 描述
Public interface IFileDataRetriever 表示在檔案同步處理提供者與自訂提供者之間彼此傳輸資料所使用的機制。

列舉型別

  列舉型別 描述
Public enumeration ChangeType 表示可以套用到目的地複寫之不同類型的變更。
Public enumeration FileSyncOptions 提供用來設定檔案同步處理提供者之行為的選項。
Public enumeration SkipReason 表示在變更偵測或變更套用期間略過檔案的原因。