WebClient.OpenRead Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

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

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

address

String

URI ditentukan sebagai String tempat mengunduh data.

Mengembalikan

Stream

Stream digunakan untuk membaca data dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

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.

OpenRead(Uri)

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

address

Uri

URI ditentukan sebagai Uri tempat mengunduh data.

Mengembalikan

Stream

Stream digunakan untuk membaca data dari sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

WebException

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.