DownloadOperation Kelas

Referensi

Definisi

Ruang nama:: Windows.Networking.BackgroundTransfer

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

Melakukan operasi pengunduhan asinkron. Sampel transfer Latar Belakang menunjukkan fungsionalitas ini. Untuk gambaran umum kemampuan Transfer Latar Belakang, lihat Mentransfer data di latar belakang.

public ref class DownloadOperation sealed : IBackgroundTransferOperationPriority

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DownloadOperation final : IBackgroundTransferOperationPriority

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DownloadOperation : IBackgroundTransferOperationPriority

Public NotInheritable Class DownloadOperation
Implements IBackgroundTransferOperationPriority

Warisan: Object Platform::Object IInspectable DownloadOperation

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan: IBackgroundTransferOperation IBackgroundTransferOperationPriority

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	internetClient internetClientServer privateNetworkClientServer

Contoh

Aplikasi sampel yang menggunakan kelas ini mencakup sampel transfer Latar Belakang.

Contoh berikut menunjukkan cara mengonfigurasi dan memulai operasi pengunduhan dasar.

using Windows.Foundation;
using Windows.Networking.BackgroundTransfer;
using Windows.Storage;

private async void StartDownload_Click(object sender, RoutedEventArgs e)
{
    try
    {
        Uri source = new Uri(serverAddressField.Text.Trim());
        string destination = fileNameField.Text.Trim();

        StorageFile destinationFile = await KnownFolders.PicturesLibrary.CreateFileAsync(
            destination, CreationCollisionOption.GenerateUniqueName);

        BackgroundDownloader downloader = new BackgroundDownloader();
        DownloadOperation download = downloader.CreateDownload(source, destinationFile);

        // Attach progress and completion handlers.
        HandleDownloadAsync(download, true);
    }
    catch (Exception ex)
    {
        LogException("Download Error", ex);
    }
}

Keterangan

Pada start-up berikutnya setelah penghentian aplikasi, aplikasi Anda harus menghitung semua instans DownloadOperation yang ada menggunakan GetCurrentDownloadsAsync. Ketika aplikasi UWP yang menggunakan Transfer Latar Belakang dihentikan, unduhan yang tidak lengkap tetap ada di latar belakang. Jika aplikasi Anda dimulai ulang setelah penghentian dan operasi yang tidak lengkap ini tidak dijumlahkan dan diperkenalkan kembali ke sesi saat ini, maka mereka akan kedaluarsa dan terus menempati sumber daya perangkat.

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

Catatan

Operasi pengunduhan yang dijeda atau tidak lengkap hanya dapat dilanjutkan jika server menerima permintaan rentang.

Pertimbangan waktu habis

Saat membuat koneksi baru untuk unduhan melalui TCP/SSL, upaya koneksi dibatalkan jika tidak dibuat dalam waktu lima menit.
Setelah koneksi dibuat, pesan permintaan HTTP yang belum menerima respons dalam waktu dua menit dibatalkan. Dengan asumsi ada konektivitas Internet, Transfer Latar Belakang akan mencoba kembali unduhan hingga tiga kali. Jika konektivitas Internet tidak terdeteksi, upaya tambahan tidak akan dilakukan sampai.

Panduan Penelusuran Kesalahan

Menghentikan sesi penelusuran kesalahan di Microsoft Visual Studio sebanding dengan menutup aplikasi Anda; unduhan dijeda dan unggahan POST dihentikan. Bahkan saat penelusuran kesalahan, aplikasi Anda harus menghitung lalu menjeda, melanjutkan, memulai ulang, atau membatalkan unduhan yang bertahan.

Namun, jika pembaruan proyek Microsoft Visual Studio, seperti perubahan pada manifes aplikasi, mengharuskan aplikasi dihapus instalannya dan disebarkan ulang untuk penelusuran kesalahan, GetCurrentDownloadsAsync tidak dapat menghitung operasi persisten yang dibuat menggunakan penyebaran aplikasi sebelumnya.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1709	16299	CurrentWebErrorStatus
1709	16299	GetDownloadedRanges
1709	16299	GetResultRandomAccessStreamReference
1709	16299	IsRandomAccessRequired
1709	16299	RentangUnduh
1709	16299	RecoverableWebErrorStatuses
1803	17134	MakeCurrentInTransferGroup
2004	19041	RemoveRequestHeader
2004	19041	SetRequestHeader

Properti

CostPolicy	Mendapatkan dan menetapkan kebijakan biaya untuk unduhan.
CurrentWebErrorStatus	WebErrorStatus transfer, yang dapat dipantau selama masa pakai DownloadOperation.
Group	Catatan Grup dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan TransferGroup. Mendapatkan nilai string yang menunjukkan grup tempat transfer berada.
Guid	Ini adalah pengidentifikasi unik untuk operasi pengunduhan tertentu. GUID yang terkait dengan operasi pengunduhan tidak akan berubah selama durasi pengunduhan.
IsRandomAccessRequired	Properti boolean untuk mengaktifkan akses acak. Properti harus diatur ke TRUE sebelum memanggil StartAsync() pada objek DownloadOperation untuk menggunakan fitur akses acak. Setelah memanggil StartAsync(), panggil GetResultRandomAccessStreamReference untuk mendapatkan referensi ke aliran akses acak dan baca darinya.
Method	Mendapatkan metode yang digunakan untuk pengunduhan.
Priority	Mendapatkan atau mengatur prioritas transfer operasi pengunduhan ini ketika berada dalam BackgroundTransferGroup. Nilai yang mungkin ditentukan oleh BackgroundTransferPriority.
Progress	Mendapatkan kemajuan operasi saat ini.
RecoverableWebErrorStatuses	Sekumpulan nilai WebErrorStatus yang diantisipasi aplikasi akan mencapai unduhan, dan bahwa aplikasi tahu cara menanganinya.
RequestedUri	Mendapatkan URI untuk mengunduh file.
ResultFile	Mengembalikan objek IStorageFile yang disediakan oleh pemanggil saat membuat objek DownloadOperation menggunakan CreateDownload.
TransferGroup	Mendapatkan grup tempat operasi pengunduhan ini berada.

Metode

AttachAsync()	Mengembalikan operasi asinkron yang dapat digunakan untuk memantau kemajuan dan penyelesaian unduhan yang dilampirkan. Memanggil metode ini memungkinkan aplikasi untuk melampirkan operasi pengunduhan yang dimulai di instans aplikasi sebelumnya.
GetDownloadedRanges()	Mengembalikan daftar lengkap rentang file yang telah diunduh sejauh ini.
GetResponseInformation()	Mendapatkan informasi respons.
GetResultRandomAccessStreamReference()	Mendapatkan referensi ke aliran akses acak dan membacanya. Anda perlu mengatur IsRandomAccessRequired ke TRUE sebelum memanggil GetResultRandomAccessStreamReference.
GetResultStreamAt(UInt64)	Mendapatkan respons yang diunduh sebagian pada posisi yang ditentukan.
MakeCurrentInTransferGroup()	Memprioritaskan operasi transfer unduhan (dan transfer apa pun yang mengikutinya dalam grup transfer yang sama). Memanggil metode ini pada transfer yang bukan milik grup transfer tidak berpengaruh.
Pause()	Menjeda operasi pengunduhan.
RemoveRequestHeader(String)	Digunakan untuk menghapus header permintaan HTTP.
Resume()	Melanjutkan operasi pengunduhan yang dijeda.
SetRequestHeader(String, String)	Digunakan untuk mengatur header permintaan HTTP.
StartAsync()	Memulai operasi pengunduhan asinkron.

Acara

RangesDownloaded

Menyediakan akses ke kemajuan pengunduhan bertahap.

Berlaku untuk

Bagikan melalui