Using the ULSyncProgressListener object, UltraLite.NET can resume partial downloads that fail because of communication errors
or user aborts. UltraLite.NET processes the download as it is received. If a download is interrupted, then the partial download
transaction remains in the database and can be resumed during the next synchronization.
If a partial download was kept, then the ULConnection.ULSyncResult.PartialDownloadRetained property is set to true when the
ULConnection.Synchronize method exits.
If the PartialDownloadRetained property is set, then you can resume a download. To do this, call the ULConnection.Synchronize
method with the ULConnection.ULSyncParms.ResumePartialDownload property set to true. It is recommended that you keep the KeepPartialDownload
property set to true in case another communications error occurs. No upload is done if a download is skipped.
The download you receive during a resumed download is as old as when the download originally began. If you need the most recent
data, then you can do another download immediately after the resumed download completes.
When resuming a download, many of the ULSyncParms properties are not relevant. For example, the Publications property is not
used. You receive the publications that you requested on the initial download. The only properties that must be set are ResumePartialDownload
and UserName. The KeepPartialDownload property can be set if desired and functions as normal.
If you have a partial download that is no longer needed, call the ULConnection.RollbackPartialDownload method to roll back
the failed download transaction. If you attempt to synchronize again and do not specify the ResumePartialDownload property,
then the partial download is rolled back before the next synchronization begins.