Partager via


Windows.Networking.BackgroundTransfer Espace de noms

Active les fonctionnalités avancées de téléchargement et de transfert de chargement au sein d’une application. Pour obtenir une vue d’ensemble des fonctionnalités de transfert en arrière-plan, consultez Transfert de données en arrière-plan. Téléchargez l’exemple de transfert en arrière-plan pour un exemple de code.

Notes

Le transfert en arrière-plan est principalement conçu pour les opérations de transfert à long terme pour les ressources telles que la vidéo, la musique et les images volumineuses. Pour les opérations à court terme impliquant des transferts de ressources plus petites (c’est-à-dire quelques Ko), les API HTTP sont recommandées. HttpClient est préféré et peut être utilisé dans tous les langages pris en charge par les applications UWP. XHR peut être utilisé dans JavaScript. IXHR2 peut être utilisé en C++.

Classes

BackgroundDownloader

Permet de configurer les téléchargements avant la création réelle de l’opération de téléchargement à l’aide de CreateDownload. Pour obtenir une vue d’ensemble des fonctionnalités de transfert en arrière-plan, consultez Transfert de données en arrière-plan. Téléchargez l’exemple de transfert en arrière-plan pour un exemple de code.

Notes

Le transfert en arrière-plan est principalement conçu pour les opérations de transfert à long terme pour des ressources telles que la vidéo, la musique et les images volumineuses. Pour les opérations à court terme impliquant des transferts de ressources plus petites (c’est-à-dire quelques Ko), utilisez l’espace de noms Windows.Web.Http .

BackgroundTransferCompletionGroup

Représente un ensemble d’opérations de transfert en arrière-plan (objets DownloadOperation ou UploadOperation ) qui déclenchent une tâche en arrière-plan une fois que toutes les opérations sont terminées (si les opérations se sont terminées avec succès) ou échouent avec une erreur.

BackgroundTransferCompletionGroupTriggerDetails

Contient des informations sur un BackgroundTransferCompletionGroup accessible uniquement à partir de la méthode Run sur IBackgroundTask.

BackgroundTransferContentPart

Représente une partie de contenu d’une demande de transfert en plusieurs parties. Chaque objet BackgroundTransferContentPart peut représenter une chaîne unique de contenu texte ou une charge utile de fichier unique, mais pas les deux.

BackgroundTransferError

Utilisé pour fournir des erreurs rencontrées lors d’une opération de transfert.

BackgroundTransferGroup

Groupe nommé utilisé pour associer plusieurs opérations de téléchargement ou de chargement. Cette classe permet à votre application de créer facilement ces groupes et d’effectuer des téléchargements et des chargements simultanément, en série ou en fonction de la priorité.

Par exemple, si un utilisateur décide de télécharger et de watch des épisodes à partir d’une série télévisée populaire, votre application peut hiérarchiser les premiers épisodes de la série ou laisser l’utilisateur choisir l’épisode à télécharger en premier.

BackgroundTransferRangesDownloadedEventArgs

Fournit l’accès aux informations sur l’événement de progression du téléchargement incrémentiel.

BackgroundUploader

Permet de configurer le chargement avant la création réelle de l’opération de chargement à l’aide de CreateUpload. Pour obtenir une vue d’ensemble des fonctionnalités de transfert en arrière-plan, consultez Transfert de données en arrière-plan. Téléchargez l’exemple de transfert en arrière-plan pour un exemple de code.

Notes

Le transfert en arrière-plan est principalement conçu pour les opérations de transfert à long terme pour des ressources telles que la vidéo, la musique et les images volumineuses. Pour les opérations à court terme impliquant des transferts de ressources plus petites (c’est-à-dire quelques Ko), utilisez l’espace de noms Windows.Web.Http .

ContentPrefetcher

Fournit des propriétés permettant de spécifier les ressources web à prérécupérer. Windows utilise l’heuristique pour tenter de télécharger les ressources spécifiées avant le lancement de votre application par l’utilisateur.

DownloadOperation

Effectue une opération de téléchargement asynchrone. L’exemple de transfert en arrière-plan illustre cette fonctionnalité. Pour obtenir une vue d’ensemble des fonctionnalités de transfert en arrière-plan, consultez Transfert de données en arrière-plan.

ResponseInformation

Représente les données retournées par une réponse du serveur.

UnconstrainedTransferRequestResult

Représente le résultat d’une demande de transferts sans contrainte à partir d’un objet BackgroundDownloader ou BackgroundUploader .

Les opérations de transfert sans contrainte peuvent s’exécuter sans les restrictions de ressources normalement associées aux opérations réseau en arrière-plan pendant qu’un appareil s’exécute sur batterie.

UploadOperation

Effectue une opération de chargement asynchrone. Pour obtenir une vue d’ensemble des fonctionnalités de transfert en arrière-plan, consultez Transfert de données en arrière-plan. Téléchargez l’exemple de transfert en arrière-plan pour un exemple de code.

Structures

BackgroundDownloadProgress

Contient status informations sur l’opération de téléchargement.

BackgroundTransferFileRange

Contient status informations sur l’opération de transfert de fichiers.

BackgroundUploadProgress

Contient status informations sur l’opération de chargement.

Interfaces

IBackgroundTransferBase

Représente une opération de transfert en arrière-plan.

IBackgroundTransferContentPartFactory

Crée un objet BackgroundTransferContentPart .

IBackgroundTransferOperation

Représente une opération de transfert en arrière-plan.

IBackgroundTransferOperationPriority

Utilisez cette interface pour déterminer la priorité d’un téléchargement ou d’un chargement dans un BackgroundTransferGroup. Les valeurs possibles sont définies par l’énumération BackgroundTransferPriority .

Énumérations

BackgroundTransferBehavior

Définit les valeurs utilisées pour indiquer si les téléchargements et les chargements au sein d’un BackgroundTransferGroup s’exécutent simultanément ou en série.

BackgroundTransferCostPolicy

Définit les valeurs utilisées pour spécifier si des transferts peuvent se produire sur des réseaux mesurés.

BackgroundTransferPriority

Indique la priorité d’une opération BackgroundTransfer (téléchargement ou chargement) en termes de planification au sein d’une application.

BackgroundTransferStatus

Définit les valeurs de status d’opération de transfert.

Remarques

Sur la plupart des plateformes, le transfert en arrière-plan continue de transférer vos fichiers (téléchargement ou chargement) même lorsque l’application est suspendue ou lorsqu’elle se ferme. Lorsque votre application démarre, vous devez appeler BackgroundDownloader.GetCurrentDownloadsAsync ou BackgroundUploader.GetCurrentUploadsAsync pour énumérer tous vos transferts incomplets. Appelez ensuite DownloadOperation.AttachAsync ou UploadOperation.AttachAsync, respectivement, sur chacune d’elles. Cette opération récupère l’état le plus récent du transfert et entraîne la reprise des transferts après un redémarrage du système. Lorsque DownloadOperation.IsRandomAccessRequired est true, le téléchargement reprend automatiquement après un redémarrage. Vous devez appeler AttachAsync même dans ce cas. Si votre application est en cours d’exécution lorsque les transferts sont terminés (autrement dit, lorsque l’appel à AttachAsync est retourné), vous pouvez effectuer un travail en réponse. Vous pouvez également utiliser BackgroundTransferCompletionGroup pour lancer une tâche en arrière-plan une fois les transferts terminés.

Sur Xbox, le transfert en arrière-plan transfère uniquement vos fichiers (téléchargement ou chargement) lorsque l’application est au premier plan. Lorsqu’une application est suspendue, placée en arrière-plan ou a quitté, les transferts en arrière-plan de l’application sont suspendus. Lorsque l’application s’exécute à nouveau au premier plan, ses transferts reprennent automatiquement.

Voir aussi