BackgroundDownloadProgress 結構
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含下載作業的狀態資訊。
/// [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。 |