Windows.Networking.BackgroundTransfer Espace de noms

Référence

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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.