Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
指定在同步时是禁用还是启用部分下载。
Public Property KeepPartialDownload As Boolean
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,并且该字段会正常工作。
如果不再需要现有的部分下载,则可以调用 ULConnection.RollbackPartialDownload() 回退失败的下载事务。此外,如果您尝试再次同步但没有指定 ResumePartialDownload,则下次同步开始之前将回退部分下载。