Windows.Networking.BackgroundTransfer Ruang nama

Referensi

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.

Edit

Memungkinkan kemampuan transfer unduhan dan unggahan tingkat lanjut dalam aplikasi. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang. Unduh sampel transfer Latar Belakang untuk contoh kode.

Catatan

Transfer latar belakang terutama dirancang untuk operasi transfer jangka panjang untuk sumber daya seperti video, musik, dan gambar besar. Untuk operasi jangka pendek yang melibatkan transfer sumber daya yang lebih kecil (yaitu beberapa KB), API HTTP direkomendasikan. HttpClient lebih disukai dan dapat digunakan dalam semua bahasa yang didukung oleh aplikasi UWP. XHR dapat digunakan dalam JavaScript. IXHR2 dapat digunakan dalam C++.

Kelas

BackgroundDownloader	Digunakan untuk mengonfigurasi unduhan sebelum pembuatan aktual operasi pengunduhan menggunakan CreateDownload. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang. Unduh sampel transfer Latar Belakang untuk contoh kode. Catatan Transfer Latar Belakang terutama dirancang untuk operasi transfer jangka panjang untuk sumber daya seperti video, musik, dan gambar besar. Untuk operasi jangka pendek yang melibatkan transfer sumber daya yang lebih kecil (yaitu beberapa KB), gunakan namespace Windows.Web.Http .
BackgroundTransferCompletionGroup	Mewakili serangkaian operasi transfer latar belakang (objek DownloadOperation atau UploadOperation ) yang memicu tugas latar belakang setelah semua operasi selesai (jika operasi berhasil diselesaikan) atau gagal dengan kesalahan.
BackgroundTransferCompletionGroupTriggerDetails	Berisi informasi tentang BackgroundTransferCompletionGroup yang hanya dapat diakses dari metode Jalankan pada IBackgroundTask.
BackgroundTransferContentPart	Mewakili bagian konten dari permintaan transfer multi-bagian. Setiap objek BackgroundTransferContentPart dapat mewakili satu string konten teks atau payload file tunggal, tetapi tidak keduanya.
BackgroundTransferError	Digunakan untuk memberikan kesalahan yang ditemui selama operasi transfer.
BackgroundTransferGroup	Grup bernama yang digunakan untuk mengaitkan beberapa operasi unduhan atau unggah. Kelas ini memudahkan aplikasi Anda untuk membuat grup ini dan menyelesaikan unduhan dan unggahan secara bersamaan, secara serial, atau berdasarkan prioritas. Misalnya, jika pengguna memutuskan untuk mengunduh dan watch episode dari seri televisi populer, aplikasi Anda dapat memprioritaskan episode paling awal dalam serial atau membiarkan pengguna memilih episode mana yang akan diunduh terlebih dahulu.
BackgroundTransferRangesDownloadedEventArgs	Menyediakan akses ke informasi tentang peristiwa kemajuan pengunduhan bertahap.
BackgroundUploader	Digunakan untuk mengonfigurasi pengunggahan sebelum pembuatan aktual operasi pengunggahan menggunakan CreateUpload. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang. Unduh sampel transfer Latar Belakang untuk contoh kode. Catatan Transfer Latar Belakang terutama dirancang untuk operasi transfer jangka panjang untuk sumber daya seperti video, musik, dan gambar besar. Untuk operasi jangka pendek yang melibatkan transfer sumber daya yang lebih kecil (yaitu beberapa KB), gunakan namespace Windows.Web.Http .
ContentPrefetcher	Menyediakan properti untuk menentukan sumber daya web yang akan diambil sebelumnya. Windows akan menggunakan heuristik untuk mencoba mengunduh sumber daya yang ditentukan sebelum aplikasi Anda diluncurkan oleh pengguna.
DownloadOperation	Melakukan operasi pengunduhan asinkron. Sampel transfer Latar Belakang menunjukkan fungsionalitas ini. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang.
ResponseInformation	Mewakili data yang dikembalikan oleh respons server.
UnconstrainedTransferRequestResult	Mewakili hasil permintaan transfer yang tidak dibatasi dari objek BackgroundDownloader atau BackgroundUploader . Operasi transfer yang tidak dibatasi dapat berjalan tanpa pembatasan sumber daya yang biasanya terkait dengan operasi jaringan latar belakang saat perangkat berjalan pada baterai.
UploadOperation	Melakukan operasi unggahan asinkron. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang. Unduh sampel transfer Latar Belakang untuk contoh kode.

Struct

BackgroundDownloadProgress	Berisi informasi status tentang operasi pengunduhan.
BackgroundTransferFileRange	Berisi informasi status tentang operasi transfer file.
BackgroundUploadProgress	Berisi informasi status tentang operasi unggahan.

Antarmuka

IBackgroundTransferBase	Mewakili operasi transfer latar belakang.
IBackgroundTransferContentPartFactory	Membuat objek BackgroundTransferContentPart .
IBackgroundTransferOperation	Mewakili operasi transfer latar belakang.
IBackgroundTransferOperationPriority	Gunakan antarmuka ini untuk menentukan prioritas unduhan atau unggahan dalam BackgroundTransferGroup. Nilai yang mungkin ditentukan oleh enumerasi BackgroundTransferPriority .

Enum

BackgroundTransferBehavior	Menentukan nilai yang digunakan untuk menunjukkan apakah unduhan dan unggahan dalam BackgroundTransferGroup berjalan secara bersamaan atau dalam serial.
BackgroundTransferCostPolicy	Menentukan nilai yang digunakan untuk menentukan apakah transfer dapat terjadi pada jaringan terukur.
BackgroundTransferPriority	Menunjukkan prioritas yang dimiliki operasi BackgroundTransfer (unduh atau unggah) dalam hal penjadwalan dalam aplikasi.
BackgroundTransferStatus	Menentukan nilai status operasi transfer.

Keterangan

Di sebagian besar platform, Transfer Latar Belakang akan terus mentransfer file Anda (unduh atau unggah) bahkan ketika aplikasi ditangguhkan atau ketika keluar. Saat aplikasi dimulai, Anda harus memanggil BackgroundDownloader.GetCurrentDownloadsAsync atau BackgroundUploader.GetCurrentUploadsAsync untuk menghitung semua transfer Anda yang tidak lengkap. Kemudian panggil DownloadOperation.AttachAsync atau UploadOperation.AttachAsync, masing-masing, pada masing-masing. Melakukannya mengambil status terbaru transfer dan menyebabkan transfer dilanjutkan setelah reboot sistem. Ketika DownloadOperation.IsRandomAccessRequired adalah true, unduhan dilanjutkan secara otomatis setelah reboot. Anda harus memanggil AttachAsync bahkan dalam hal ini. Jika aplikasi Anda berjalan saat transfer selesai (yaitu, saat panggilan ke AttachAsync kembali), maka Anda dapat melakukan pekerjaan sebagai respons. Atau, Anda dapat menggunakan BackgroundTransferCompletionGroup untuk meluncurkan tugas latar belakang saat transfer selesai.

Di Xbox, Transfer Latar Belakang hanya mentransfer file Anda (unduh atau unggah) saat aplikasi berada di latar depan. Saat aplikasi ditangguhkan, dimasukkan ke latar belakang, atau telah keluar, transfer latar belakang aplikasi ditangguhkan. Saat aplikasi berjalan di latar depan lagi, transfernya dilanjutkan secara otomatis.