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 に設定されます。 |