Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - .NET 编程 » UltraLite .NET 2.0 API 参考 » ULSyncParms 类

 

KeepPartialDownload 属性

指定在同步时是禁用还是启用部分下载。

语法
Visual Basic
Public Property KeepPartialDownload As Boolean
C#
public bool KeepPartialDownload { get; set; }
属性值

如果在同步时启用部分下载,则为 true;如果禁用部分下载,则为 false。缺省值为 false。

注释

UltraLite.NET 能够通过 ULSyncProgressListener 重新启动由于通信错误或用户中止而失败的下载。UltraLite.NET 在接收下载的过程中对其进行处理。如果下载被中断,则部分下载事务仍保留在数据库中,并且可在下一次同步过程中恢复。

要指示 UltraLite.NET 应保存部分下载,请指定 connection.SyncParms.KeepPartialDownload=true,否则当发生错误时将回退下载。

如果保留了部分下载,则当 connection.Synchronize() 退出时,输出字段 connection.SyncResult.ULSyncResult.PartialDownloadRetained 将设置为 true。

如果设置了 PartialDownloadRetained,则可以继续下载。为此,请在调用 connection.Synchronize() 时将 connection.SyncParms.ULSyncParms.ResumePartialDownload 设置为 true。当出现其它通信错误时,我们也建议您保持将 KeepPartialDownload 设置为 true。如果跳过某一下载,将不执行任何上载。

您在恢复下载期间接收的下载会与下载最初开始时一样旧。如果您需要最新数据,则可以在专门的恢复下载完成后再立即进行一次下载。

在恢复下载时,许多 ULSyncParms 字段是无关的字段。例如,Publications 字段就是不使用的字段。您会收到在最初下载时请求的发布。只需要设置字段 ResumePartialDownload 和 UserName。如果您愿意,也可以设置字段 KeepPartialDownload 和 DisableConcurrency,两个字段都会正常工作。

如果不再需要现有的部分下载,则可以调用 ULConnection.RollbackPartialDownload() 回退失败的下载事务。此外,如果您尝试再次同步但没有指定 ResumePartialDownload,则下次同步开始之前将回退部分下载。

有关详细信息,请参见恢复失败的下载

另请参见