WebClient.OpenRead 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 untuk data yang diunduh dari sumber daya dengan URI yang ditentukan.
Overload
OpenRead(String) |
Membuka aliran yang dapat dibaca untuk data yang diunduh dari sumber daya dengan URI yang ditentukan sebagai String. |
OpenRead(Uri) |
Membuka aliran yang dapat dibaca untuk data yang diunduh dari sumber daya dengan URI yang ditentukan sebagai Uri. |
OpenRead(String)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Membuka aliran yang dapat dibaca untuk data yang diunduh dari sumber daya dengan URI yang ditentukan sebagai String.
public:
System::IO::Stream ^ OpenRead(System::String ^ address);
public System.IO.Stream OpenRead (string address);
member this.OpenRead : string -> System.IO.Stream
Public Function OpenRead (address As String) As Stream
Parameter
Mengembalikan
Stream digunakan untuk membaca data dari sumber daya.
Pengecualian
Parameter address
null
.
URI yang dibentuk dengan menggabungkan BaseAddress, address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh data.
Contoh
Contoh kode berikut membuka sumber daya yang diidentifikasi oleh uriString
dan menampilkan hasilnya di konsol sistem.
Stream yang dikembalikan oleh OpenRead ditutup saat data telah dibaca.
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Accessing {0} ...", uriString );
// Open a stream to point to the data stream coming from the Web resource.
Stream^ myStream = myWebClient->OpenRead( uriString );
Console::WriteLine( "\nDisplaying Data :\n" );
StreamReader^ sr = gcnew StreamReader( myStream );
Console::WriteLine( sr->ReadToEnd() );
// Close the stream.
myStream->Close();
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data.
Console.WriteLine("Accessing {0} ...", uriString);
// Open a stream to point to the data stream coming from the Web resource.
Stream myStream = myWebClient.OpenRead(uriString);
Console.WriteLine("\nDisplaying Data :\n");
StreamReader sr = new StreamReader(myStream);
Console.WriteLine(sr.ReadToEnd());
// Close the stream.
myStream.Close();
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Download home page data.
Console.WriteLine("Accessing {0} ...", uriString)
' Open a stream to point to the data stream coming from the Web resource.
Dim myStream As Stream = myWebClient.OpenRead(uriString)
Console.WriteLine(ControlChars.Cr + "Displaying Data :" + ControlChars.Cr)
Dim sr As New StreamReader(myStream)
Console.WriteLine(sr.ReadToEnd())
' Close the stream.
myStream.Close()
Keterangan
Hati
WebRequest
, HttpWebRequest
, ServicePoint
, dan WebClient
usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Metode OpenRead membuat instans Stream yang digunakan untuk membaca konten sumber daya yang ditentukan oleh parameter address
. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi saat menunggu aliran, gunakan salah satu metode OpenReadAsync.
Jika properti BaseAddress bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data 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
Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.
Nota
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.
Berlaku untuk
OpenRead(Uri)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
Membuka aliran yang dapat dibaca untuk data yang diunduh dari sumber daya dengan URI yang ditentukan sebagai Uri.
public:
System::IO::Stream ^ OpenRead(Uri ^ address);
public System.IO.Stream OpenRead (Uri address);
member this.OpenRead : Uri -> System.IO.Stream
Public Function OpenRead (address As Uri) As Stream
Parameter
Mengembalikan
Stream digunakan untuk membaca data dari sumber daya.
Pengecualian
Parameter address
null
.
URI yang dibentuk dengan menggabungkan BaseAddress, address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh data.
Keterangan
Hati
WebRequest
, HttpWebRequest
, ServicePoint
, dan WebClient
usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.
Metode OpenRead membuat instans Stream yang digunakan untuk membaca konten sumber daya yang ditentukan oleh parameter address
. Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi saat menunggu aliran, gunakan salah satu metode OpenReadAsync.
Jika properti BaseAddress bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data 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
Anda harus memanggil Stream.Close setelah selesai dengan Stream untuk menghindari kehabisan sumber daya sistem.
Nota
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing 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