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

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

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

語法

'宣告
Public Sub New ( _
    replicaId As Guid, _
    rootDirectoryPath As String, _
    scopeFilter As FileSyncScopeFilter, _
    fileSyncOptions As FileSyncOptions, _
    metadataDirectoryPath As String, _
    metadataFileName As String, _
    tempDirectoryPath As String, _
    pathToSaveConflictLoserFiles As String _
)
'用途
Dim replicaId As Guid
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(replicaId, _
    rootDirectoryPath, scopeFilter, _
    fileSyncOptions, metadataDirectoryPath, _
    metadataFileName, tempDirectoryPath, _
    pathToSaveConflictLoserFiles)

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

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

new : 
        replicaId:Guid * 
        rootDirectoryPath:string * 
        scopeFilter:FileSyncScopeFilter * 
        fileSyncOptions:FileSyncOptions * 
        metadataDirectoryPath:string * 
        metadataFileName:string * 
        tempDirectoryPath:string * 
        pathToSaveConflictLoserFiles:string -> FileSyncProvider

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

參數

• replicaId
  型別：System. . :: . .Guid
  複寫的識別碼。

• rootDirectoryPath
  型別：System. . :: . .String
  此提供者之本機檔案存放區的絕對路徑。這是包含要同步處理之檔案和子資料夾的資料夾。

• scopeFilter
  型別：Microsoft.Synchronization.Files. . :: . .FileSyncScopeFilter
  靜態範圍篩選，可指定本機檔案存放區內的哪些檔案或目錄會包含在此範圍內。可為 nullNothingnullptrunitnull 參考 (在 Visual Basic 中為 Nothing)。

• fileSyncOptions
  型別：Microsoft.Synchronization.Files. . :: . .FileSyncOptions
  在同步處理期間決定提供者之行為的旗標。

• metadataDirectoryPath
  型別：System. . :: . .String
  中繼資料儲存區檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。應用程式必須確定有使用正確等級的安全性權限來保護此目錄的安全，以免資訊外洩。

• metadataFileName
  型別：System. . :: . .String
  中繼資料儲存區檔案的名稱。

• tempDirectoryPath
  型別：System. . :: . .String
  將存放暫存檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。應用程式必須確定有使用正確等級的安全性權限來保護此目錄的安全，以免資訊外洩。

• pathToSaveConflictLoserFiles
  型別：System. . :: . .String
  將存放成為衝突失敗者之檔案的絕對路徑。在呼叫這個建構函式之前，必須先建立此目錄。若要協助避免資訊外洩，應用程式必須確定有使用適當等級的安全性權限來保護此目錄的安全。可為 nullNothingnullptrunitnull 參考 (在 Visual Basic 中為 Nothing)。

例外

例外狀況	條件
ArgumentNullException	rootDirectoryPath 是 null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 。
ArgumentException	replicaId 是 Empty；rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 的長度為 0；rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 包含萬用字元，或者 rootDirectoryPath、metadataDirectoryPath、tempDirectoryPath, or pathToSaveConflictLoserFiles 不存在。
ArgumentOutOfRangeException	fileSyncOptions 不在 FileSyncOptions 列舉中。
ReplicaMetadataInUseException	另一個提供者執行個體已經使用目錄路徑和中繼資料檔案路徑的相同值來初始化，但是尚未釋放。

請參閱

參考

FileSyncProvider類別

FileSyncProvider 成員

FileSyncProvider 多載

Microsoft.Synchronization.Files 命名空間