BackgroundDownloader.CreateDownloadAsync Méthode
Définition
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.
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
- 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
Opération de téléchargement asynchrone résultante.
- Attributs
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).