WebClient.DownloadDataTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

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

Overload

DownloadDataTaskAsync(String)	Mengunduh sumber daya sebagai array Byte dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
DownloadDataTaskAsync(Uri)	Mengunduh sumber daya sebagai array Byte dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

DownloadDataTaskAsync(String)

Sumber:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);

member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

Parameter

address

String

URI sumber daya yang akan diunduh.

Mengembalikan

Task<Byte[]>

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah sumber daya data diunduh.

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

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.

Contoh kode berikut meminta data dari server dan menampilkan data yang dikembalikan. Ini mengasumsikan bahwa remoteUri berisi URI yang valid untuk data yang diminta.

DownloadDataTaskAsync(Uri)

Sumber:

WebClient.cs

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);

member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

Parameter

address

Uri

URI sumber daya yang akan diunduh.

Mengembalikan

Task<Byte[]>

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah sumber daya data diunduh.

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

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.