WebClient.OpenRead Metoda

Definice

Obor názvů:

System.Net

Sestavení:

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í

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, ze kterého se mají stahovat data.

Návraty

Stream

Stream sloužící ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress, address 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. Stream vrácená OpenRead se zavře při čtení dat.

// 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ří instanci Stream sloužící 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 metod OpenReadAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString 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í Stream je nutné volat Stream.Close, abyste se vyhnuli výpadku 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, ze kterého se mají stahovat data.

Návraty

Stream

Stream sloužící ke čtení dat z prostředku.

Výjimky

ArgumentNullException

Parametr address je null.

WebException

Identifikátor URI vytvořený kombinací BaseAddress, address 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ří instanci Stream sloužící 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 metod OpenReadAsync.

Pokud BaseAddress vlastnost není prázdný řetězec ("") a address neobsahuje absolutní identifikátor URI, address musí být relativní identifikátor URI, který se zkombinuje s BaseAddress k vytvoření absolutního identifikátoru URI požadovaných dat. Pokud QueryString 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í Stream je nutné volat Stream.Close, abyste se vyhnuli výpadku 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.