WebClient.DownloadStringTaskAsync 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.
Mengunduh sumber daya sebagai String dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.
Overload
| DownloadStringTaskAsync(String) |
Mengunduh sumber daya sebagai String dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. |
| DownloadStringTaskAsync(Uri) |
Mengunduh sumber daya sebagai String dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. |
DownloadStringTaskAsync(String)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunduh sumber daya sebagai String dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As String) As Task(Of String)Parameter
- address
- String
URI sumber daya yang akan diunduh.
Mengembalikan
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi sumber daya yang diunduh.
- Atribut
Pengecualian
Parameter addressnull.
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.
Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah sumber daya data diunduh. 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.
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.
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.
Berlaku untuk
DownloadStringTaskAsync(Uri)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunduh sumber daya sebagai String dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)Parameter
- address
- Uri
URI sumber daya yang akan diunduh.
Mengembalikan
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi sumber daya yang diunduh.
- Atribut
Pengecualian
Parameter addressnull.
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.
Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah sumber daya data diunduh. 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.
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.
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.
