Sync 方法

Public Function Sync(
    ByVal syncName As String,
    ByVal opts As String
) As UInt32

public UInt32 Sync(String syncName, String opts)

syncName 在远程数据库中定义的包含同步选项的同步配置文件的名称。如果 syncName 为空值，则不会使用配置文件并且 opts 参数应包含所有用于同步的选项。
opts 根据为同步配置文件定义选项字符串所使用的相同规则形成的字符串，指定为分号分隔的格式为 <选项名称>="">=<选项值>=""> 的元素列表。如果 syncName 为非空值，则由 opts 指定的选项将被附加到由 syncName 指定的同步配置文件中的现有选项。如果字符串中的选项已在配置文件中存在，那么字符串的值会替换已存储在配置文件中的值。如果 syncName 为空值，则 opts 应为同步指定所有选项。请参见CREATE SYNCHRONIZATION PROFILE 语句 [MobiLink]。

用于唯一地标识此同步请求的一个整数值，且该数值仅在客户端断开与服务器的连接之前有效。如果错误阻止了对同步请求的创建，则返回 NULL_SYNCHDL。返回 NULL_SYNCHDL 时，您可调用 GetErrorInfo 方法获取有关失败的详细信息。

只有连接到服务器才能调用此方法。syncName 和 opts 中的至少一个必须为非空值。

返回值标识同步请求并可用于取消该请求或处理同步返回的事件。

以下 C# 代码示例演示如何在调用 Sync 方法后显示错误代码。

// Insert code to initialize the syncronization client.

UInt32 request = syncClient.Sync("syncName", null);
if (request == DbmlsyncClient.NULL_SYNCHDL) {
    string error_code = syncClient.GetErrorInfo().type.ToString();
    MessageBox.Show(error_code, "Sync Error");
}

GetErrorInfo 方法

Sync 方法

Visual Basic 语法

C# 语法

参数

返回值

注释

另请参见