BackgroundDownloader.CreateDownload Metode

Definisi

Ruang nama:

Windows.Networking.BackgroundTransfer

Overload

CreateDownload(Uri, IStorageFile)	Menginisialisasi objek DownloadOperation yang berisi Uri yang ditentukan dan file tempat respons ditulis.
CreateDownload(Uri, IStorageFile, IStorageFile)	Menginisialisasi objek DownloadOperation dengan Uri sumber daya, file tempat respons ditulis, dan isi entitas permintaan.

CreateDownload(Uri, IStorageFile)

Menginisialisasi objek DownloadOperation yang berisi Uri yang ditentukan dan file tempat respons ditulis.

public:
 virtual DownloadOperation ^ CreateDownload(Uri ^ uri, IStorageFile ^ resultFile) = CreateDownload;

/// [Windows.Foundation.Metadata.Overload("CreateDownload")]
DownloadOperation CreateDownload(Uri const& uri, IStorageFile const& resultFile);

[Windows.Foundation.Metadata.Overload("CreateDownload")]
public DownloadOperation CreateDownload(System.Uri uri, IStorageFile resultFile);

function createDownload(uri, resultFile)

Public Function CreateDownload (uri As Uri, resultFile As IStorageFile) As DownloadOperation

Parameter

uri

Uri Uri

Lokasi sumber daya.

resultFile

IStorageFile

File tempat respons akan ditulis.

Mengembalikan

DownloadOperation

Operasi pengunduhan yang dihasilkan.

Atribut

OverloadAttribute

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.

Penting

Membuat sejumlah besar transfer pada utas UI utama dengan CreateDownload dapat mengakibatkan penurunan performa UI aplikasi Anda. Jika Anda mengantre sejumlah besar transfer, disarankan agar Anda memanggil CreateDownload pada utas pekerja latar belakang seperti dalam contoh berikut.

operation = await Task.Run(() => { return myDownloader.CreateDownload(uri, file); });

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).

Lihat juga

• CreateDownload(Uri, IStorageFile, IStorageFile)

CreateDownload(Uri, IStorageFile, IStorageFile)

Menginisialisasi objek DownloadOperation dengan Uri sumber daya, file tempat respons ditulis, dan isi entitas permintaan.

public:
 virtual DownloadOperation ^ CreateDownload(Uri ^ uri, IStorageFile ^ resultFile, IStorageFile ^ requestBodyFile) = CreateDownload;

/// [Windows.Foundation.Metadata.Overload("CreateDownloadFromFile")]
DownloadOperation CreateDownload(Uri const& uri, IStorageFile const& resultFile, IStorageFile const& requestBodyFile);

[Windows.Foundation.Metadata.Overload("CreateDownloadFromFile")]
public DownloadOperation CreateDownload(System.Uri uri, IStorageFile resultFile, IStorageFile requestBodyFile);

function createDownload(uri, resultFile, requestBodyFile)

Public Function CreateDownload (uri As Uri, resultFile As IStorageFile, requestBodyFile As IStorageFile) As DownloadOperation

Parameter

uri

Uri Uri

Lokasi sumber daya.

resultFile

IStorageFile

File tempat respons akan ditulis.

requestBodyFile

IStorageFile

File yang mewakili isi entitas permintaan, yang berisi data tambahan yang diperlukan server sebelum unduhan dapat dimulai. File yang dirujuk objek ini harus valid selama durasi pengunduhan.

Mengembalikan

DownloadOperation

Operasi pengunduhan yang dihasilkan.

Atribut

OverloadAttribute

Keterangan

DownloadOperation yang dihasilkan mendukung skenario di mana permintaan unduhan yang valid berisi data tertentu yang diperlukan oleh server. Misalnya, situs web memerlukan formulir yang diisi sebelum unduhan dapat berlangsung.

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.

Penting

Membuat sejumlah besar transfer pada utas UI utama dengan CreateDownload dapat mengakibatkan penurunan performa UI aplikasi Anda. Jika Anda mengantre sejumlah besar transfer, disarankan agar Anda memanggil CreateDownload pada utas pekerja latar belakang seperti dalam contoh berikut.

operation = await Task.Run(() => { return myDownloader.CreateDownload(uri, file); });

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).

Lihat juga

• CreateDownload(Uri, IStorageFile)