WebClient.DownloadDataTaskAsync 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 Byte array dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.
Overload
DownloadDataTaskAsync(String) |
Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. |
DownloadDataTaskAsync(Uri) |
Mengunduh sumber daya sebagai Byte array dari URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. |
DownloadDataTaskAsync(String)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunduh sumber daya sebagai Byte array 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array yang Byte berisi sumber daya yang diunduh.
- Atribut
Pengecualian
Parameternya address
adalah null
.
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.
Metode ini mengambil sumber daya yang ditentukan menggunakan metode default untuk protokol yang terkait dengan skema URI yang ditentukan dalam address
parameter . Data diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.
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.
Contoh kode berikut meminta data dari server dan menampilkan data yang dikembalikan. Ini mengasumsikan bahwa remoteUri
berisi URI yang valid untuk data yang diminta.
Berlaku untuk
DownloadDataTaskAsync(Uri)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Mengunduh sumber daya sebagai Byte array 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array yang Byte berisi sumber daya yang diunduh.
- Atribut
Pengecualian
Parameternya address
adalah null
.
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.
Metode ini mengambil sumber daya yang ditentukan menggunakan metode default untuk protokol yang terkait dengan skema URI yang ditentukan dalam address
parameter . Data diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.
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