Windows.Networking.BackgroundTransfer Namespace

  • Referenz
Bearbeiten

Ermöglicht erweiterte Download- und Uploadübertragungsfunktionen innerhalb einer App. Eine Übersicht über die Funktionen der Hintergrundübertragung finden Sie unter Übertragen von Daten im Hintergrund. Laden Sie das Beispiel für die Hintergrundübertragung für ein Codebeispiel herunter.

Hinweis

Die Hintergrundübertragung ist in erster Linie für langfristige Übertragungsvorgänge für Ressourcen wie Video, Musik und große Bilder konzipiert. Für kurzfristige Vorgänge mit Übertragungen kleinerer Ressourcen (d. h. ein paar KB) werden die HTTP-APIs empfohlen. HttpClient wird bevorzugt und kann in allen Sprachen verwendet werden, die von UWP-Apps unterstützt werden. XHR kann in JavaScript verwendet werden. IXHR2 kann in C++ verwendet werden.

Klassen

BackgroundDownloader

Wird verwendet, um Downloads vor der eigentlichen Erstellung des Downloadvorgangs mithilfe von CreateDownload zu konfigurieren. Eine Übersicht über die Funktionen der Hintergrundübertragung finden Sie unter Übertragen von Daten im Hintergrund. Laden Sie das Beispiel für die Hintergrundübertragung für ein Codebeispiel herunter.

Hinweis

Die Hintergrundübertragung ist in erster Linie für langfristige Übertragungsvorgänge für Ressourcen wie Video, Musik und große Bilder konzipiert. Verwenden Sie für kurzfristige Vorgänge mit Übertragungen kleinerer Ressourcen (d. h. ein paar KB) den Windows.Web.Http-Namespace .
BackgroundTransferCompletionGroup

Stellt eine Reihe von Hintergrundübertragungsvorgängen (DownloadOperation - oder UploadOperation-Objekte ) dar, die eine Hintergrundaufgabe auslösen, sobald alle Vorgänge abgeschlossen wurden (wenn die Vorgänge erfolgreich abgeschlossen wurden) oder ein Fehler auftritt.
BackgroundTransferCompletionGroupTriggerDetails

Enthält Informationen zu einem BackgroundTransferCompletionGroup-Objekt , auf das nur über die Run-Methode für IBackgroundTask zugegriffen werden kann.
BackgroundTransferContentPart

Stellt einen Inhaltsteil einer mehrteiligen Übertragungsanforderung dar. Jedes BackgroundTransferContentPart-Objekt kann entweder eine einzelne Zeichenfolge mit Textinhalt oder eine einzelne Dateinutzlast darstellen, aber nicht beides.
BackgroundTransferError

Wird verwendet, um Fehler bereitzustellen, die während eines Übertragungsvorgangs aufgetreten sind.
BackgroundTransferGroup

Eine benannte Gruppe, die verwendet wird, um mehrere Download- oder Uploadvorgänge zuzuordnen. Diese Klasse erleichtert Es Ihrer App, diese Gruppen zu erstellen und Downloads und Uploads gleichzeitig, in seriell oder basierend auf der Priorität durchzuführen.

Wenn sich ein Benutzer beispielsweise entscheidet, Episoden aus einer beliebten Fernsehserie herunterzuladen und zu watch, kann Ihre App die frühesten Episoden in der Serie priorisieren oder dem Benutzer die Auswahl überlassen, welche Episode zuerst heruntergeladen werden soll.
BackgroundTransferRangesDownloadedEventArgs

Bietet Zugriff auf Informationen zum Fortschrittsereignis für inkrementelle Downloads.
BackgroundUploader

Wird verwendet, um den Upload vor der eigentlichen Erstellung des Uploadvorgangs mithilfe von CreateUpload zu konfigurieren. Eine Übersicht über die Funktionen der Hintergrundübertragung finden Sie unter Übertragen von Daten im Hintergrund. Laden Sie das Beispiel für die Hintergrundübertragung für ein Codebeispiel herunter.

Hinweis

Die Hintergrundübertragung ist in erster Linie für langfristige Übertragungsvorgänge für Ressourcen wie Video, Musik und große Bilder konzipiert. Verwenden Sie für kurzfristige Vorgänge mit Übertragungen kleinerer Ressourcen (d. h. ein paar KB) den Windows.Web.Http-Namespace .
ContentPrefetcher

Stellt Eigenschaften zum Angeben von Webressourcen bereit, die vorab abgerufen werden sollen. Windows verwendet die Heuristik, um zu versuchen, die angegebenen Ressourcen herunterzuladen, bevor die App vom Benutzer gestartet wird.
DownloadOperation

Führt einen asynchronen Downloadvorgang aus. Im Beispiel für die Hintergrundübertragung wird diese Funktionalität veranschaulicht. Eine Übersicht über die Funktionen der Hintergrundübertragung finden Sie unter Übertragen von Daten im Hintergrund.
ResponseInformation

Stellt Daten dar, die von einer Serverantwort zurückgegeben werden.
UnconstrainedTransferRequestResult

Stellt das Ergebnis einer Anforderung für uneingeschränkte Übertragungen von einem BackgroundDownloader - oder BackgroundUploader-Objekt dar.

Nicht eingeschränkte Übertragungsvorgänge können ohne die Ressourceneinschränkungen ausgeführt werden, die normalerweise mit Hintergrundnetzwerkvorgängen verbunden sind, während ein Gerät mit Akku ausgeführt wird.
UploadOperation

Führt einen asynchronen Uploadvorgang aus. Eine Übersicht über die Funktionen der Hintergrundübertragung finden Sie unter Übertragen von Daten im Hintergrund. Laden Sie das Beispiel für die Hintergrundübertragung für ein Codebeispiel herunter.

Strukturen

BackgroundDownloadProgress

Enthält status Informationen zum Downloadvorgang.
BackgroundTransferFileRange

Enthält status Informationen zum Dateiübertragungsvorgang.
BackgroundUploadProgress

Enthält status Informationen zum Uploadvorgang.

Schnittstellen

IBackgroundTransferBase

Stellt einen Hintergrundübertragungsvorgang dar.
IBackgroundTransferContentPartFactory

Erstellt ein BackgroundTransferContentPart-Objekt .
IBackgroundTransferOperation

Stellt einen Hintergrundübertragungsvorgang dar.
IBackgroundTransferOperationPriority

Verwenden Sie diese Schnittstelle, um die Priorität von Downloads oder Uploads innerhalb einer BackgroundTransferGroup zu bestimmen. Mögliche Werte werden durch die BackgroundTransferPriority-Enumeration definiert.

Enumerationen

BackgroundTransferBehavior

Definiert Werte, die verwendet werden, um anzugeben, ob Downloads und Uploads innerhalb einer BackgroundTransferGroup gleichzeitig oder in seriell ausgeführt werden.
BackgroundTransferCostPolicy

Definiert Werte, die verwendet werden, um anzugeben, ob Übertragungen in getakteten Netzwerken erfolgen können.
BackgroundTransferPriority

Gibt die Priorität an, die ein BackgroundTransfer-Vorgang (Download oder Upload) in Bezug auf die Planung innerhalb einer App hat.
BackgroundTransferStatus

Definiert Den Übertragungsvorgang status Werte.

Hinweise

Auf den meisten Plattformen wird die Hintergrundübertragung Ihre Dateien weiterhin übertragen (Herunterladen oder Hochladen), auch wenn die App angehalten oder beendet wird. Wenn Ihre App gestartet wird, sollten Sie BackgroundDownloader.GetCurrentDownloadsAsync oder BackgroundUploader.GetCurrentUploadsAsync aufrufen, um alle Unvollständigen Übertragungen aufzulisten. Rufen Sie dann DownloadOperation.AttachAsync bzw . UploadOperation.AttachAsync auf. Dadurch wird der aktuelle Status der Übertragung abgerufen, und die Übertragungen werden nach einem Systemneustart fortgesetzt. Wenn DownloadOperation.IsRandomAccessRequired ist true, wird der Download nach einem Neustart automatisch fortgesetzt. Sie sollten AttachAsync auch in diesem Fall aufrufen. Wenn Ihre App ausgeführt wird, wenn die Übertragungen abgeschlossen sind (d. h. wenn der Aufruf von AttachAsync zurückgegeben wird), können Sie als Antwort arbeiten. Alternativ können Sie BackgroundTransferCompletionGroup verwenden, um eine Hintergrundaufgabe zu starten, wenn die Übertragungen abgeschlossen sind.

Auf der Xbox überträgt die Hintergrundübertragung Ihre Dateien nur dann (herunterladen oder hochladen), wenn sich die App im Vordergrund befindet. Wenn eine App entweder angehalten, im Hintergrund platziert oder beendet wurde, werden die Hintergrundübertragungen der App angehalten. Wenn die App erneut im Vordergrund ausgeführt wird, werden die Übertragungen automatisch fortgesetzt.

Weitere Informationen