WebClient.OpenReadAsync 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.
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
- Sumber:
- WebClient.cs
- 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
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress dan alamat tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
-atau-
Terjadi kesalahan saat membuka aliran.
Keterangan
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. Untuk menerima pemberitahuan saat aliran tersedia, tambahkan penanganan aktivitas ke OpenReadCompleted acara.
Catatan
Anda harus memanggil Stream.Close ketika Anda selesai dengan untuk menghindari kehabisan Stream sumber daya sistem.
Metode ini tidak memblokir utas panggilan saat aliran terbuka. Untuk memblokir saat menunggu aliran, gunakan OpenReadAsync metode .
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 merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari 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.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Metode ini disimpan dalam tugas yang menampilkan 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).
Berlaku untuk
OpenReadAsync(Uri, Object)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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);
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
Parameternya address
adalah null
.
URI yang dibentuk dengan menggabungkan BaseAddress dan alamat tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
-atau-
Terjadi kesalahan saat membuka aliran.
Keterangan
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. Untuk menerima pemberitahuan saat aliran tersedia, tambahkan penanganan aktivitas ke OpenReadCompleted acara.
Catatan
Anda harus memanggil Stream.Close ketika Anda selesai dengan untuk menghindari kehabisan Stream sumber daya sistem.
Metode ini tidak memblokir utas panggilan saat aliran terbuka. Untuk memblokir saat menunggu aliran, gunakan OpenRead metode .
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 merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari 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.
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