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。

適用於

另請參閱