WebClient.OpenReadTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.WebClient.dll

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.

Overload

Nama	Deskripsi
OpenReadTaskAsync(String)	Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
OpenReadTaskAsync(Uri)	Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

OpenReadTaskAsync(String)

Sumber:

WebClient.cs

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);

member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Parameter

address

String

URI sumber daya yang akan diambil.

Mengembalikan

Task<Stream>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan data yang Stream digunakan untuk membaca dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan alamat tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah aliran yang dapat dibaca ke sumber daya data telah dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans yang Stream digunakan untuk mengakses sumber daya yang ditentukan oleh address parameter . Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close ketika Anda selesai dengan untuk menghindari kehabisan Stream sumber daya sistem.

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 menentukan URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut sumber daya yang diminta. QueryString Jika properti tidak null, 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 Pelacakan Jaringan di .NET Framework.

Lihat juga

• Stream

OpenReadTaskAsync(Uri)

Sumber:

WebClient.cs

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);

member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Parameter

address

Uri

URI sumber daya yang akan diambil.

Mengembalikan

Task<Stream>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan data yang Stream digunakan untuk membaca dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan alamat tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

-atau-

Terjadi kesalahan saat membuka aliran.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah aliran yang dapat dibaca ke sumber daya data telah dibuka. Metode ini tidak memblokir utas panggilan saat aliran terbuka.

Metode ini mengambil instans yang Stream digunakan untuk mengakses sumber daya yang ditentukan oleh address parameter . Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

Nota

Anda harus memanggil Stream.Close ketika Anda selesai dengan untuk menghindari kehabisan Stream sumber daya sistem.

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 menentukan URI absolut, address harus URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut sumber daya yang diminta. QueryString Jika properti tidak null, 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 Pelacakan Jaringan di .NET Framework.

Lihat juga

• Stream