BackgroundDownloader.CreateDownloadAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat operasi pengunduhan asinkron yang menyertakan URI, file tempat respons akan ditulis, dan objek IInputStream tempat konten file dibaca.
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)
Parameter
- resultFile
- IStorageFile
Mewakili file tempat respons akan ditulis.
- requestBodyStream
- IInputStream
Aliran yang mewakili isi entitas permintaan.
Mengembalikan
Operasi pengunduhan asinkron yang dihasilkan.
- Atribut
Keterangan
Transfer latar belakang tidak mendukung unduhan bersamaan dari Uri yang sama. Jadi aplikasi dapat mengunduh http://example.com/myfile.wmv
sekali, atau mengunduhnya lagi setelah unduhan sebelumnya selesai. Aplikasi tidak boleh memulai dua unduhan Uri yang sama secara bersamaan, karena ini dapat mengakibatkan file yang terpotok.
Catatan
Beberapa sistem file memiliki batas ukuran file. Transfer latar belakang memiliki logika khusus untuk transfer gagal cepat yang melebihi batas ukuran file drive tujuan (misalnya, file yang melebihi ukuran 4GB untuk sistem file FAT32). Jika server merespons dengan nilai header yang Content-Length
lebih besar dari ukuran file maksimum sistem file, maka operasi pengunduhan segera gagal dengan HRESULT_FROM_WIN32(ERROR_FILE_SYSTEM_LIMITATION).