Windows.Networking.BackgroundTransfer Ruang nama
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.
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.
Lihat juga
- HttpClient
- Windows.Storage
- Menambahkan dukungan untuk jaringan
- Cara mengonfigurasi kemampuan isolasi jaringan
- Mulai cepat: Mengunduh file
- Mulai cepat: Mengunggah file
- Mentransfer file dari sumber daya jaringan
- Mentransfer data di latar belakang
- IXHR2
- XHR
- Sampel transfer latar belakang
- Sampel transfer latar belakang (Windows 8.x)