FileSyncProvider 建構 (String, FileSyncScopeFilter, FileSyncOptions)
初始化 FileSyncProvider 類別的新執行個體，這個執行個體是以指定的根目錄路徑、範圍篩選和組態選項為基礎。
命名空間： Microsoft.Synchronization.Files
組件： Microsoft.Synchronization.Files (在 Microsoft.Synchronization.Files.dll 中)
語法
'宣告
Public Sub New ( _
rootDirectoryPath As String, _
scopeFilter As FileSyncScopeFilter, _
fileSyncOptions As FileSyncOptions _
)
'用途
Dim rootDirectoryPath As String
Dim scopeFilter As FileSyncScopeFilter
Dim fileSyncOptions As FileSyncOptions
Dim instance As New FileSyncProvider(rootDirectoryPath, _
scopeFilter, fileSyncOptions)
public FileSyncProvider(
string rootDirectoryPath,
FileSyncScopeFilter scopeFilter,
FileSyncOptions fileSyncOptions
)
public:
FileSyncProvider(
String^ rootDirectoryPath,
FileSyncScopeFilter^ scopeFilter,
FileSyncOptions fileSyncOptions
)
new :
rootDirectoryPath:string *
scopeFilter:FileSyncScopeFilter *
fileSyncOptions:FileSyncOptions -> FileSyncProvider
public function FileSyncProvider(
rootDirectoryPath : String,
scopeFilter : FileSyncScopeFilter,
fileSyncOptions : FileSyncOptions
)
參數
- rootDirectoryPath
型別：System. . :: . .String
此提供者之本機檔案存放區的絕對路徑。這是包含要同步處理之檔案和子資料夾的資料夾。
- scopeFilter
型別：Microsoft.Synchronization.Files. . :: . .FileSyncScopeFilter
靜態範圍篩選，可指定本機檔案存放區內的哪些檔案或目錄會包含在此範圍內。可為 nullNothingnullptrunitnull 參考 (在 Visual Basic 中為 Nothing)。
- fileSyncOptions
型別：Microsoft.Synchronization.Files. . :: . .FileSyncOptions
在同步處理期間決定提供者之行為的旗標。預設值為 None。
例外
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | rootDirectoryPath 是 null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 。 |
| ArgumentException | rootDirectoryPath 的長度為 0、rootDirectoryPath 包含萬用字元，或者 rootDirectoryPath 不存在。 |
| ArgumentOutOfRangeException | fileSyncOptions 不在 FileSyncOptions 列舉中。 |
| ReplicaMetadataInUseException | 另一個提供者執行個體已經使用目錄路徑和中繼資料檔案路徑的相同值來初始化，但是尚未釋放。 |
備註
如果應用程式沒有使用複寫識別碼來識別複寫，就可以使用這個形式的建構函式。在這種情況下，物件會建立並使用複寫識別碼，然後將它儲存在中繼資料儲存區檔案中。
這個形式的建構函式會將中繼資料儲存區檔案和暫存檔案的位置初始化為 rootDirectoryPath。它會將儲存衝突失敗者檔案的路徑初始化為 null Nothing nullptr unit null 參考 (在 Visual Basic 中為 Nothing) 。它會將中繼資料儲存區檔案命名為 filesync.metadata。