WebClient.DownloadStringAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunduh sumber daya yang ditentukan sebagai String atau Uri. Metode ini tidak memblokir utas panggilan.

Overload

DownloadStringAsync(Uri)	Mengunduh sumber daya yang ditentukan sebagai Uri. Metode ini tidak memblokir utas panggilan.
DownloadStringAsync(Uri, Object)	Mengunduh string yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

DownloadStringAsync(Uri)

Sumber:

WebClient.cs

Mengunduh sumber daya yang ditentukan sebagai Uri. Metode ini tidak memblokir utas panggilan.

public:
 void DownloadStringAsync(Uri ^ address);

public void DownloadStringAsync (Uri address);

member this.DownloadStringAsync : Uri -> unit

Public Sub DownloadStringAsync (address As Uri)

Parameter

address

Uri

Uri yang berisi URI untuk diunduh.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sumber daya diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Setelah mengunduh sumber daya, metode ini menggunakan pengodean yang ditentukan dalam properti Encoding untuk mengonversi sumber daya ke String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir sambil menunggu respons server, gunakan metode DownloadString. Setelah pengunduhan selesai, peristiwa DownloadStringCompleted dinaikkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. String yang diunduh tersedia di properti Result.

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

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

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

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing 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 DownloadString(Uri).

DownloadStringAsync(Uri, Object)

Sumber:

WebClient.cs

Mengunduh string yang ditentukan ke sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

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

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

member this.DownloadStringAsync : Uri * obj -> unit

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

Parameter

address

Uri

Uri yang berisi URI untuk diunduh.

userToken

Object

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

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Sumber daya diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Setelah mengunduh sumber daya, metode ini menggunakan pengodean yang ditentukan dalam properti Encoding untuk mengonversi sumber daya ke String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir sambil menunggu respons server, gunakan metode DownloadString. Setelah pengunduhan selesai, peristiwa DownloadStringCompleted dinaikkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. String yang diunduh tersedia di properti Result.

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

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

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

Nota

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