WebClient.DownloadStringAsync Metode
Definisi
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.
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
- Sumber:
- WebClient.cs
- 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
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress dan address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
Keterangan
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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir saat menunggu respons server, gunakan metode .DownloadString Setelah pengunduhan selesai, DownloadStringCompleted peristiwa akan dimunculkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. String yang diunduh tersedia di Result properti .
Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.
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 menampilkan 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).
Berlaku untuk
DownloadStringAsync(Uri, Object)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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);
public void DownloadStringAsync (Uri address, object userToken);
member this.DownloadStringAsync : Uri * obj -> unit
Public Sub DownloadStringAsync (address As Uri, userToken As Object)
Parameter
- userToken
- Object
Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil ketika operasi asinkron selesai.
Pengecualian
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress dan address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
Keterangan
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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya. Untuk mengunduh sumber daya dan memblokir saat menunggu respons server, gunakan metode .DownloadString Setelah pengunduhan selesai, DownloadStringCompleted peristiwa akan dimunculkan. Aplikasi Anda harus menangani kejadian ini untuk menerima pemberitahuan. String yang diunduh tersedia di Result properti .
Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk