Partager via

BackgroundDownloader.CreateDownloadAsync Méthode

  • Référence

Définition

Espace de noms:
Windows.Networking.BackgroundTransfer
Modifier

Crée une opération de téléchargement asynchrone qui inclut un URI, le fichier dans lequel la réponse sera écrite et l’objet IInputStream à partir duquel le contenu du fichier est lu.

public:
 virtual IAsyncOperation<DownloadOperation ^> ^ CreateDownloadAsync(Uri ^ uri, IStorageFile ^ resultFile, IInputStream ^ requestBodyStream) = CreateDownloadAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<DownloadOperation> CreateDownloadAsync(Uri const& uri, IStorageFile const& resultFile, IInputStream const& requestBodyStream);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<DownloadOperation> CreateDownloadAsync(System.Uri uri, IStorageFile resultFile, IInputStream requestBodyStream);
function createDownloadAsync(uri, resultFile, requestBodyStream)
Public Function CreateDownloadAsync (uri As Uri, resultFile As IStorageFile, requestBodyStream As IInputStream) As IAsyncOperation(Of DownloadOperation)

Paramètres

uri
Uri Uri

Emplacement de la ressource.

resultFile
IStorageFile

Représente le fichier dans lequel la réponse sera écrite.

requestBodyStream
IInputStream

Flux qui représente le corps de l’entité de demande.

Retours

IAsyncOperation<DownloadOperation>

Opération de téléchargement asynchrone résultante.

Attributs
RemoteAsyncAttribute

Remarques

Le transfert en arrière-plan ne prend pas en charge les téléchargements simultanés du même URI. Ainsi, une application peut télécharger http://example.com/myfile.wmv une seule fois, ou la télécharger à nouveau une fois le téléchargement précédent terminé. Une application ne doit pas démarrer simultanément deux téléchargements du même URI , car cela peut entraîner des fichiers tronqués.

Notes

Certains systèmes de fichiers ont des limites de taille de fichier. Le transfert en arrière-plan a une logique spéciale pour les transferts à échec rapide qui dépassent les limites de taille de fichier du lecteur de destination (par exemple, les fichiers dont la taille dépasse 4 Go pour les systèmes de fichiers FAT32). Si le serveur répond avec une valeur d’en-tête Content-Length supérieure à la taille de fichier maximale du système de fichiers, l’opération de téléchargement échoue immédiatement avec HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).

S’applique à

Voir aussi