BackgroundDownloadProgress Struktur

  • Referenz

Definition

Namespace:
Windows.Networking.BackgroundTransfer
Bearbeiten

Enthält status Informationen zum Downloadvorgang.

/// [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
Vererbung
ValueType
BackgroundDownloadProgress
Attribute
ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

BytesReceived

Die Gesamtanzahl der empfangenen Datenbytes. Dieser Wert enthält keine Bytes, die als Antwortheader empfangen werden. Downloadvorgänge können neu gestartet werden (z. B. nach einem Netzwerkausfall). Wenn Vorgänge neu gestartet werden, müssen sie möglicherweise zuvor heruntergeladene Bytes verwerfen, und daher steigt die Anzahl der heruntergeladenen Bytes möglicherweise nicht immer von einem Bericht zum nächsten.
HasResponseChanged

TRUE , wenn sich die Antwort auf die Downloadanforderung geändert hat; Andernfalls false.

Wenn neue Antwortinformationen aufgrund einer neuen Anforderung verfügbar sind, wird dieses Feld auf TRUE festgelegt. Die Anwendung kann dann die neuen Antwortinformationen lesen und bei Bedarf ihren Zustand aktualisieren.
HasRestarted

TRUE , wenn ein Datenübertragungsvorgang neu gestartet wurde; andernfalls false.

Wenn ein Download unterbrochen wird und eine neue Anforderung an den Server gesendet wird, um den Download fortzusetzen, wird HasRestarted auf TRUE festgelegt, wenn der Server die Fortsetzung nicht unterstützt und der Download von vorn beginnen musste.

HasRestarted ist nur in der ersten Statusbenachrichtigung, die nach dem Neustart gesendet wird, auf TRUE festgelegt. Nach der ersten Statusbenachrichtigung wird HasRestarted in späteren Benachrichtigungen auf false festgelegt.
Status

Ein BackgroundTransferStatus mit dem aktuellen status des Downloadvorgangs.
TotalBytesToReceive

Die Gesamtanzahl der herunterzuladenden Datenbytes. Wenn diese Zahl unbekannt ist, wird dieser Wert auf 0 festgelegt.

Gilt für:

Weitere Informationen