WebClient.OpenRead Methode

Definitie

Naamruimte:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Hiermee opent u een leesbare stroom voor de gegevens die zijn gedownload uit een resource met de opgegeven URI.

Overloads

Name Description
OpenRead(String)

Hiermee opent u een leesbare stroom voor de gegevens die zijn gedownload uit een resource met de URI die is opgegeven als een String.
OpenRead(Uri)

Hiermee opent u een leesbare stroom voor de gegevens die zijn gedownload uit een resource met de URI die is opgegeven als een Uri.

OpenRead(String)

Hiermee opent u een leesbare stroom voor de gegevens die zijn gedownload uit een resource met de URI die is opgegeven als een 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

Parameters

address
String

De URI die is opgegeven als een String van waaruit gegevens moeten worden gedownload.

Retouren

Stream

Een Stream gebruikt om gegevens uit een resource te lezen.

Uitzonderingen

ArgumentNullException

De address parameter is null.

WebException

De URI die wordt gevormd door combinatie BaseAddress, address is ongeldig.

– of –

Er is een fout opgetreden tijdens het downloaden van gegevens.

Voorbeelden

In het volgende codevoorbeeld wordt de resource geopend die is geïdentificeerd door uriString en worden de resultaten op de systeemconsole weergegeven. De Stream geretourneerde waarde OpenRead wordt gesloten wanneer de gegevens zijn gelezen.

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

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met OpenRead de methode maakt u een Stream exemplaar dat wordt gebruikt om de inhoud van de resource te lezen die is opgegeven door de address parameter. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenReadAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap niet nullis, wordt deze toegevoegd aan address.

Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.

Note

U moet aanroepen Stream.Close wanneer u klaar bent om Stream te voorkomen dat er geen systeembronnen meer beschikbaar zijn.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

OpenRead(Uri)

Hiermee opent u een leesbare stroom voor de gegevens die zijn gedownload uit een resource met de URI die is opgegeven als een 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

Parameters

address
Uri

De URI die is opgegeven als een Uri van waaruit gegevens moeten worden gedownload.

Retouren

Stream

Een Stream gebruikt om gegevens uit een resource te lezen.

Uitzonderingen

ArgumentNullException

De address parameter is null.

WebException

De URI die wordt gevormd door combinatie BaseAddress, address is ongeldig.

– of –

Er is een fout opgetreden tijdens het downloaden van gegevens.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met OpenRead de methode maakt u een Stream exemplaar dat wordt gebruikt om de inhoud van de resource te lezen die is opgegeven door de address parameter. Deze methode blokkeert tijdens het openen van de stream. Als u wilt doorgaan met het uitvoeren van de stream, gebruikt u een van de OpenReadAsync methoden.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap niet nullis, wordt deze toegevoegd aan address.

Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.

Note

U moet aanroepen Stream.Close wanneer u klaar bent om Stream te voorkomen dat er geen systeembronnen meer beschikbaar zijn.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op