WebClient.OpenReadAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

Overload

OpenReadAsync(Uri)	Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.
OpenReadAsync(Uri, Object)	Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

OpenReadAsync(Uri)

Sumber:

WebClient.cs

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync (Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

Parameter

address

Uri

URI sumber daya yang akan diambil.

Pengecualian

ArgumentNullException

Parameter addressnull.

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, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengambil instans Stream yang digunakan untuk mengakses sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat streaming tersedia, tambahkan penanganan aktivitas ke peristiwa OpenReadCompleted.

Nota

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

Metode ini tidak memblokir utas panggilan saat aliran terbuka. Untuk memblokir saat menunggu aliran, gunakan metode OpenReadAsync.

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

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh OpenRead(Uri).

OpenReadAsync(Uri, Object)

Sumber:

WebClient.cs

Membuka aliran yang dapat dibaca yang berisi sumber daya yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);

public void OpenReadAsync (Uri address, object? userToken);

member this.OpenReadAsync : Uri * obj -> unit

Public Sub OpenReadAsync (address As Uri, userToken As Object)

Parameter

address

Uri

URI sumber daya yang akan diambil.

userToken

Object

Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil ketika operasi asinkron selesai.

Pengecualian

ArgumentNullException

Parameter addressnull.

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, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengambil instans Stream yang digunakan untuk mengakses sumber daya yang ditentukan oleh parameter address. Aliran diperoleh menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat streaming tersedia, tambahkan penanganan aktivitas ke peristiwa OpenReadCompleted.

Nota

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

Metode ini tidak memblokir utas panggilan saat aliran terbuka. Untuk memblokir saat menunggu aliran, gunakan metode OpenRead.

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