WebClient.DownloadStringTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

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

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);

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

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array yang Byte berisi sumber daya yang 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

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> 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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya.

Dalam .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 dikombinasikan 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.

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

DownloadStringTaskAsync(Uri)

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);

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

Task<String>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array yang Byte berisi sumber daya yang 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

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> 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 Encoding properti untuk mengonversi sumber daya menjadi String. Metode ini tidak memblokir utas panggilan saat mengunduh sumber daya.

Dalam .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 dikombinasikan 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.

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