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

ダウンロードが中断され、ダウンロードを再開するための新しい要求がサーバーに送信されると、サーバーが再開をサポートせず、ダウンロードをやり直す必要がある場合、 HasRestartedtrue に設定されます。

HasRestarted は、再起動後に送信された最初の進行状況通知でのみ true に設定されます。 最初の進行状況通知の後、 HasRestarted は後の通知で false に設定されます。

Status

ダウンロード操作の現在の状態を含む BackgroundTransferStatus

TotalBytesToReceive

ダウンロードするデータの合計バイト数。 この数値が不明な場合、この値は 0 に設定されます。

適用対象

こちらもご覧ください