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 asal untuk mengunduh data.

Mengembalikan

Stream

Digunakan Stream untuk membaca data dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

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. yang Stream dikembalikan oleh OpenRead ditutup ketika 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

Metode ini OpenRead membuat instans yang Stream digunakan untuk membaca konten sumber daya yang ditentukan oleh address parameter . Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenReadAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan null, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

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

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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 asal untuk mengunduh data.

Mengembalikan

Stream

Digunakan Stream untuk membaca data dari sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress, address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh data.

Keterangan

Metode ini OpenRead membuat instans yang Stream digunakan untuk membaca konten sumber daya yang ditentukan oleh address parameter . Metode ini memblokir saat membuka aliran. Untuk terus mengeksekusi sambil menunggu aliran, gunakan salah OpenReadAsync satu metode .

BaseAddress Jika properti bukan string kosong ("") dan address tidak berisi URI absolut, address harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan null, properti ditambahkan ke address.

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

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

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.