WebClient.OpenRead Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Otwiera czytelny strumień danych pobranych z zasobu przy użyciu określonego identyfikatora URI.
Przeciążenia
OpenRead(String) |
Otwiera czytelny strumień danych pobranych z zasobu z identyfikatorem StringURI określonym jako . |
OpenRead(Uri) |
Otwiera czytelny strumień danych pobranych z zasobu z identyfikatorem UriURI określonym jako . |
OpenRead(String)
Otwiera czytelny strumień danych pobranych z zasobu z identyfikatorem StringURI określonym jako .
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
Zwraca
Element Stream służący do odczytywania danych z zasobu.
Wyjątki
Parametr address
ma wartość null
.
Identyfikator URI utworzony przez połączenie elementu BaseAddressaddress
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania danych.
Przykłady
Poniższy przykład kodu otwiera zasób zidentyfikowany przez uriString
program i wyświetla wyniki w konsoli systemu. Zwrócony Stream przez OpenRead element jest zamykany, gdy dane zostały odczytane.
// 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
Metoda OpenRead tworzy Stream wystąpienie używane do odczytywania zawartości zasobu określonego address
przez parametr . Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenReadAsync metod.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie null
ma wartości , jest dołączana do address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.
Uwaga
Po zakończeniu należy wywołać Stream.Close metodę , Stream aby uniknąć wyczerpania zasobów systemowych.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.
Dotyczy
OpenRead(Uri)
Otwiera czytelny strumień danych pobranych z zasobu z identyfikatorem UriURI określonym jako .
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
Zwraca
Element Stream służący do odczytywania danych z zasobu.
Wyjątki
Parametr address
to null
.
Identyfikator URI utworzony przez połączenie BaseAddressaddress
elementu jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania danych.
Uwagi
Metoda OpenRead tworzy Stream wystąpienie używane do odczytywania zawartości zasobu określonego address
przez parametr . Ta metoda blokuje podczas otwierania strumienia. Aby kontynuować wykonywanie podczas oczekiwania na strumień, użyj jednej z OpenReadAsync metod.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie null
ma wartości , jest dołączana do address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.
Uwaga
Po zakończeniu należy wywołać Stream.Close element , Stream aby uniknąć wyczerpania zasobów systemowych.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.