BackgroundDownloader.CreateDownloadAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea un'operazione di download asincrona che include un URI, il file in cui verrà scritta la risposta e l'oggetto IInputStream da cui vengono letti i contenuti del file.
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)Parametri
- resultFile
- IStorageFile
Rappresenta il file a cui verrà scritta la risposta.
- requestBodyStream
- IInputStream
Flusso che rappresenta il corpo dell'entità richiesta.
Restituisce
Operazione di download asincrona risultante.
- Attributi
Commenti
Il trasferimento in background non supporta download simultanei dello stesso URI. Quindi un'app può scaricare http://example.com/myfile.wmv una volta o scaricarla nuovamente dopo il completamento di un download precedente. Un'app non deve avviare due download dello stesso URI simultaneamente, poiché questo potrebbe causare file troncati.
Nota
Alcuni file system hanno limiti di dimensioni file. Il trasferimento in background ha una logica speciale per i trasferimenti con errori rapidi che superano i limiti delle dimensioni del file dell'unità di destinazione, ad esempio i file che superano i 4 GB di dimensioni per i file system FAT32. Se il server risponde con un Content-Length valore di intestazione maggiore delle dimensioni massime del file system, l'operazione di download ha esito negativo immediatamente con HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).