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.

Применяется к

См. также раздел