BackgroundDownloadProgress 结构

定义

包含有关下载操作的状态信息。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
struct BackgroundDownloadProgress
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public struct BackgroundDownloadProgress
var backgroundDownloadProgress = {
bytesReceived : /* Your value */,
totalBytesToReceive : /* Your value */,
status : /* Your value */,
hasResponseChanged : /* Your value */,
hasRestarted : /* Your value */
}
Public Structure BackgroundDownloadProgress
继承
BackgroundDownloadProgress
属性

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

字段

BytesReceived

接收的数据字节总数。 此值不包括作为响应标头接收的字节。 下载操作可以在 (重启,例如,在网络中断) 之后。 重新启动操作时,它们可能必须放弃以前下载的字节,因此下载的字节数可能并不总是从一个报表增加到下一个报表。

HasResponseChanged

如果下载请求响应已更改,则为 true;否则为 false

每当由于调用新请求而提供新的响应信息时,此字段将设置为 true。 然后,应用程序可以选择读取新的响应信息并更新其状态(如果需要)。

HasRestarted

如果数据传输操作已重启,则为 true;否则为 false

当下载中断并且向服务器发送新请求以恢复下载时,如果服务器不支持恢复并且必须重新开始下载, 则 HasRestarted 设置为 true

HasRestarted 仅在重启后发送的第一个进度通知中设置为 true 。 第一个进度通知后,在以后的通知中, HasRestarted 将设置为 false

Status

一个 BackgroundTransferStatus ,其中包含下载操作的当前状态。

TotalBytesToReceive

要下载的数据的总字节数。 如果此数字未知,则此值设置为 0。

适用于

另请参阅