通过

FileSyncProvider 构造函数 (Guid, String, FileSyncScopeFilter, FileSyncOptions, String, String, String, String)

  • 项目

初始化 FileSyncProvider 类的一个新实例，该实例基于指定的副本 ID、根目录路径、作用域筛选器、配置选项、元数据存储文件路径、元数据存储文件名称、临时文件路径以及冲突解决落选方文件的存储路径。

命名空间: 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
)

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

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

参数

  • replicaId
    副本的 ID。
  • rootDirectoryPath
    此提供程序的本地文件存储区的绝对路径。这是包含要同步的文件和子文件夹的文件夹。
  • scopeFilter
    一个静态作用域筛选器，指定本地文件存储区中的哪些文件或目录包含在作用域内。可为 null 引用（在 Visual Basic 中为 Nothing）。
  • fileSyncOptions
    同步期间确定提供程序的行为的标志。
  • metadataDirectoryPath
    元数据存储文件的绝对路径。该目录必须在调用此构造函数之前创建。应用程序必须确保此目录得到正确级别的安全权限的保护，以防止信息泄露。
  • metadataFileName
    元数据存储文件的名称。
  • tempDirectoryPath
    将在其中存储临时文件的绝对路径。该目录必须在调用此构造函数之前创建。应用程序必须确保此目录得到正确级别的安全权限的保护，以防止信息泄露。
  • pathToSaveConflictLoserFiles
    将在其中存储冲突解决落选方文件的绝对路径。该目录必须在调用此构造函数之前创建。为了防止消息泄露，应用程序必须确保此目录得到适当级别的安全权限的保护。可为 null 引用（在 Visual Basic 中为 Nothing）。

异常

异常类型 条件

ArgumentNullException

rootDirectoryPath 为 null 引用（在 Visual Basic 中为 Nothing）。

ArgumentException

replicaId 为 Empty；rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 的长度为 0；rootDirectoryPath、metadataDirectoryPath、metadataFileName、tempDirectoryPath 或 pathToSaveConflictLoserFiles 包含通配符；或者 rootDirectoryPath、metadataDirectoryPath、tempDirectoryPath 或 pathToSaveConflictLoserFiles 不存在。

ArgumentOutOfRangeException

fileSyncOptions 不在 FileSyncOptions 枚举中。

ReplicaMetadataInUseException

此前，使用相同的目录路径值和元数据文件路径值对另一个提供程序实例进行了初始化，但尚未释放。

请参阅

参考

FileSyncProvider 类
FileSyncProvider 成员
Microsoft.Synchronization.Files 命名空间