WebClient.OpenRead Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebClient.dll

Otevře čitelný datový proud pro data stažená z prostředku se zadaným identifikátorem URI.

Přetížení

Name	Description
OpenRead(String)	Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným jako .String
OpenRead(Uri)	Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným jako .Uri

OpenRead(String)

Zdroj:

WebClient.cs

Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným 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

Identifikátor URI zadaný jako String identifikátor URI, ze kterého se mají stahovat data.

Návraty

Stream

Používá Stream se ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressaddress je neplatný.

-nebo-

Při stahování dat došlo k chybě.

Příklady

Následující příklad kódu otevře prostředek identifikovaný uriString a zobrazí výsledky v systémové konzole. Vrácená Stream data OpenRead se zavře, když se data načtou.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenRead vytvoří Stream instanci použitou ke čtení obsahu prostředku určeného parametrem address . Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z OpenReadAsync metod.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není null, je připojena k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

Po dokončení je nutné volat Stream.Close , abyste se vyhnuli výpadku Stream systémových prostředků.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

OpenRead(Uri)

Zdroj:

WebClient.cs

Otevře čitelný datový proud pro data stažená z prostředku s identifikátorem URI zadaným 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

Identifikátor URI zadaný jako Uri identifikátor URI, ze kterého se mají stahovat data.

Návraty

Stream

Používá Stream se ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddressaddress je neplatný.

-nebo-

Při stahování dat došlo k chybě.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda OpenRead vytvoří Stream instanci použitou ke čtení obsahu prostředku určeného parametrem address . Tato metoda blokuje při otevírání datového proudu. Pokud chcete pokračovat v provádění při čekání na datový proud, použijte jednu z OpenReadAsync metod.

BaseAddress Pokud vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, musí být relativní identifikátor URI, address který se zkombinuje s absolutním identifikátorem BaseAddress URI požadovaných dat. QueryString Pokud vlastnost není null, je připojena k address.

Tato metoda používá příkaz RETR ke stažení prostředku FTP. Pro prostředek HTTP se používá metoda GET.

Poznámka

Po dokončení je nutné volat Stream.Close , abyste se vyhnuli výpadku Stream systémových prostředků.

Poznámka

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.