Windows.Networking.BackgroundTransfer Namespace

Referenz

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.