WebClient.OpenRead Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Otwiera czytelny strumień danych pobranych z zasobu z określonym identyfikatorem URI.

Przeciążenia

OpenRead(String)	Otwiera czytelny strumień danych pobranych z zasobu przy użyciu identyfikatora URI określonego jako String.
OpenRead(Uri)	Otwiera czytelny strumień danych pobranych z zasobu przy użyciu identyfikatora URI określonego jako Uri.

OpenRead(String)

Źródło:

WebClient.cs

Otwiera czytelny strumień danych pobranych z zasobu przy użyciu identyfikatora URI określonego jako 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

Parametry

address

String

Identyfikator URI określony jako String, z którego mają być pobierane dane.

Zwraca

Stream

Stream używany do odczytywania danych z zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress, address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania danych.

Przykłady

Poniższy przykład kodu otwiera zasób zidentyfikowany przez uriString i wyświetla wyniki w konsoli systemu. Stream zwracana przez OpenRead jest zamykana po odczytaniu danych.

// 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()

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Metoda OpenRead tworzy wystąpienie Stream używane do odczytywania zawartości zasobu określonego przez parametr address. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z metod OpenReadAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest null, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć braku zasobów systemowych.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

OpenRead(Uri)

Źródło:

WebClient.cs

Otwiera czytelny strumień danych pobranych z zasobu przy użyciu identyfikatora URI określonego jako 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

Parametry

address

Uri

Identyfikator URI określony jako Uri, z którego mają być pobierane dane.

Zwraca

Stream

Stream używany do odczytywania danych z zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress, address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania danych.

Uwagi

Ostrożność

WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.

Metoda OpenRead tworzy wystąpienie Stream używane do odczytywania zawartości zasobu określonego przez parametr address. Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z metod OpenReadAsync.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest null, jest dołączana do address.

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Należy wywołać Stream.Close po zakończeniu pracy z Stream, aby uniknąć braku zasobów systemowych.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.