WebClient.DownloadDataAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron. Metode ini tidak memblokir utas panggilan.

Overload

DownloadDataAsync(Uri)	Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron.
DownloadDataAsync(Uri, Object)	Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron.

DownloadDataAsync(Uri)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron.

public:
 void DownloadDataAsync(Uri ^ address);

public void DownloadDataAsync (Uri address);

member this.DownloadDataAsync : Uri -> unit

Public Sub DownloadDataAsync (address As Uri)

Parameter

address

Uri

yang Uri berisi URI untuk diunduh.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

Keterangan

Metode ini mengambil sumber daya yang ditentukan menggunakan metode default untuk protokol yang terkait dengan skema URI yang ditentukan dalam address. Data diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir sambil menunggu respons server, gunakan salah DownloadData satu metode . Setelah pengunduhan selesai, DownloadDataCompleted peristiwa akan dinaikkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. Data yang diunduh tersedia di Result properti .

Dalam .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh DownloadData(Uri).

DownloadDataAsync(Uri, Object)

Sumber:

WebClient.cs

Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron.

public:
 void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadDataAsync (Uri address, object? userToken);

member this.DownloadDataAsync : Uri * obj -> unit

Public Sub DownloadDataAsync (address As Uri, userToken As Object)

Parameter

address

Uri

yang Uri berisi URI untuk diunduh.

userToken

Object

Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil saat operasi asinkron selesai.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

Keterangan

Metode ini mengambil sumber daya yang ditentukan menggunakan metode default untuk protokol yang terkait dengan skema URI yang ditentukan dalam address. Data diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir sambil menunggu respons server, gunakan salah DownloadData satu metode . Setelah pengunduhan selesai, DownloadDataCompleted peristiwa akan dinaikkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. Data yang diunduh tersedia di Result properti .

Dalam .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.