WebClient.OpenReadTaskAsync 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 sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.
Overload
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
- Sumber:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan yang Stream digunakan untuk membaca data dari sumber daya.
- Atribut
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
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.
Catatan
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 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.
Lihat juga
Berlaku untuk
OpenReadTaskAsync(Uri)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan yang Stream digunakan untuk membaca data dari sumber daya.
- Atribut
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
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.
Catatan
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 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.
Lihat juga
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