WebClient.OpenRead Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.WebClient.dll

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

Przeciążenia

Nazwa	Opis
OpenRead(String)	Otwiera strumień czytelny dla danych pobranych z zasobu przy użyciu identyfikatora URI określonego Stringjako .
OpenRead(Uri)	Otwiera strumień czytelny dla danych pobranych z zasobu przy użyciu identyfikatora URI określonego Urijako .

OpenRead(String)

Źródło:

WebClient.cs

Otwiera strumień czytelny dla danych pobranych z zasobu przy użyciu identyfikatora URI określonego Stringjako .

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 identyfikator String , z którego mają być pobierane dane.

Zwraca

Stream

Element Stream służący do odczytywania danych z zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddressaddress elementu 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. Zwrócony przez OpenRead element Stream 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

Ostrożność

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

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, address musi być względnym identyfikatorem URI połączonym z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie nullma wartości , jest dołączana do addresselementu .

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

Nuta

Po zakończeniu należy wywołać Stream.Close element , 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 strumień czytelny dla danych pobranych z zasobu przy użyciu identyfikatora URI określonego Urijako .

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 identyfikator Uri , z którego mają być pobierane dane.

Zwraca

Stream

Element Stream służący do odczytywania danych z zasobu.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddressaddress elementu jest nieprawidłowy.

-lub-

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

Uwagi

Ostrożność

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

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, address musi być względnym identyfikatorem URI połączonym z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie nullma wartości , jest dołączana do addresselementu .

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

Nuta

Po zakończeniu należy wywołać Stream.Close element , 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.