共用方式為

FileSyncProvider 建構 (String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String)

  • 發行項

初始化 FileSyncProvider 類別的新執行個體，這個執行個體是以指定的根目錄路徑、範圍篩選、組態選項、中繼資料儲存區檔案路徑、中繼資料儲存區檔案名稱、暫存檔案路徑和存放衝突失敗者檔案的路徑為基礎。

命名空間: Microsoft.Synchronization.Files
組件: Microsoft.Synchronization.Files (在 microsoft.synchronization.files.dll)

語法

'宣告
Public Sub New ( _
    rootDirectoryPath As String, _
    scopeFilter As FileSyncScopeFilter, _
    fileSyncOptions As FileSyncOptions, _
    metadataDirectoryPath As String, _
    metadataFileName As String, _
    tempDirectoryPath As String, _
    pathToSaveConflictLoserFiles As String _
)
'用途
Dim rootDirectoryPath As String
Dim scopeFilter As FileSyncScopeFilter
Dim fileSyncOptions As FileSyncOptions
Dim metadataDirectoryPath As String
Dim metadataFileName As String
Dim tempDirectoryPath As String
Dim pathToSaveConflictLoserFiles As String

Dim instance As New FileSyncProvider(rootDirectoryPath, scopeFilter, fileSyncOptions, metadataDirectoryPath, metadataFileName, tempDirectoryPath, pathToSaveConflictLoserFiles)

public FileSyncProvider (
    string rootDirectoryPath,
    FileSyncScopeFilter scopeFilter,
    FileSyncOptions fileSyncOptions,
    string metadataDirectoryPath,
    string metadataFileName,
    string tempDirectoryPath,
    string pathToSaveConflictLoserFiles
)

public:
FileSyncProvider (
    String^ rootDirectoryPath, 
    FileSyncScopeFilter^ scopeFilter, 
    FileSyncOptions fileSyncOptions, 
    String^ metadataDirectoryPath, 
    String^ metadataFileName, 
    String^ tempDirectoryPath, 
    String^ pathToSaveConflictLoserFiles
)

public FileSyncProvider (
    String rootDirectoryPath, 
    FileSyncScopeFilter scopeFilter, 
    FileSyncOptions fileSyncOptions, 
    String metadataDirectoryPath, 
    String metadataFileName, 
    String tempDirectoryPath, 
    String pathToSaveConflictLoserFiles
)

public function FileSyncProvider (
    rootDirectoryPath : String, 
    scopeFilter : FileSyncScopeFilter, 
    fileSyncOptions : FileSyncOptions, 
    metadataDirectoryPath : String, 
    metadataFileName : String, 
    tempDirectoryPath : String, 
    pathToSaveConflictLoserFiles : String
)

參數

  • rootDirectoryPath
    此提供者之本機檔案存放區的絕對路徑。這是包含要同步處理之檔案和子資料夾的資料夾。
  • scopeFilter
    靜態範圍篩選，可指定本機檔案存放區內的哪些檔案或目錄會包含在此範圍內。可為 null 參考 (在 Visual Basic 中為 Nothing)。
  • fileSyncOptions
    在同步處理期間決定提供者之行為的旗標。
  • metadataDirectoryPath
    中繼資料儲存區檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。應用程式必須確定有使用正確等級的安全性權限來保護此目錄的安全，以免資訊外洩。
  • metadataFileName
    中繼資料儲存區檔案的名稱。
  • tempDirectoryPath
    將存放暫存檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。應用程式必須確定有使用正確等級的安全性權限來保護此目錄的安全，以免資訊外洩。
  • pathToSaveConflictLoserFiles
    將存放成為衝突失敗者之檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。若要協助避免資訊外洩，應用程式必須確定有使用適當等級的安全性權限來保護此目錄的安全。可為 null 參考 (在 Visual Basic 中為 Nothing)。

例外

例外狀況型別 條件

ArgumentNullException

rootDirectoryPath 是 null 參考 (在 Visual Basic 中為 Nothing)。

ArgumentException

rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 的長度為 0；rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 包含萬用字元，或者 rootDirectoryPath、metadataDirectoryPath、tempDirectoryPath, or pathToSaveConflictLoserFiles 不存在。

ArgumentOutOfRangeException

fileSyncOptions 不在 FileSyncOptions 列舉中。

ReplicaMetadataInUseException

另一個提供者執行個體已經使用目錄路徑和中繼資料檔案路徑的相同值來初始化，但是尚未釋放。

備註

如果應用程式沒有使用複寫識別碼來識別複寫，就可以使用這個形式的建構函式。在這種情況下，物件會建立並使用複寫識別碼，然後將它儲存在中繼資料儲存區檔案中。

請參閱

參考

FileSyncProvider 類別
FileSyncProvider 成員
Microsoft.Synchronization.Files 命名空間