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

OpenRead(String)

Zdroj:

WebClient.cs

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

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

Návraty

Stream

Slouží Stream 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ý uživatelem uriString a zobrazí výsledky v systémové konzole. Stream Vrácené uživatelem OpenRead se po přečtení dat zavře.

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

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, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. Pokud vlastnost QueryString není null, připojí se k address.

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

Poznámka

Pokud chcete zabránit tomu, že dojde systémové prostředky, musíte po dokončení Stream volání volatStream.Close.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete 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 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

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

Návraty

Stream

Slouží Stream 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

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, address musí být relativní identifikátor URI, který je kombinován sBaseAddress, aby vytvořil absolutní identifikátor URI požadovaných dat. Pokud vlastnost QueryString není null, připojí se k address.

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

Poznámka

Pokud chcete zabránit tomu, že dojde systémové prostředky, musíte po dokončení Stream volání volatStream.Close.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.