WebClient.OpenRead Methode

Definition

Öffnet einen lesbaren Stream für die von einer Ressource mit dem angegebenen URI heruntergeladenen Daten.

Überlädt

OpenRead(String)

Öffnet einen lesbaren Stream für die von einer Ressource mit dem als String angegebenen URI heruntergeladenen Daten.

OpenRead(Uri)

Öffnet einen lesbaren Stream für die von einer Ressource mit dem als Uri angegebenen URI heruntergeladenen Daten.

OpenRead(String)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen lesbaren Stream für die von einer Ressource mit dem als String angegebenen URI heruntergeladenen Daten.

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

Parameter

address
String

Der als String angegebene URI, von dem Daten heruntergeladen werden.

Gibt zurück

Ein zum Lesen von Daten aus einer Ressource verwendeter Stream.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Herunterladen von Daten.

Beispiele

Im folgenden Codebeispiel wird die von identifizierte uriString Ressource geöffnet und die Ergebnisse in der Systemkonsole angezeigt. Die Stream zurückgegebene von OpenRead wird geschlossen, wenn die Daten gelesen wurden.

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

Hinweise

Die OpenRead -Methode erstellt eine Stream instance, die verwendet wird, um den Inhalt der ressource zu lesen, die durch den address Parameter angegeben wird. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der Methoden, um die Ausführung während des Wartens auf den OpenReadAsync Stream fortzusetzen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft nicht nullist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für:

OpenRead(Uri)

Quelle:
WebClient.cs
Quelle:
WebClient.cs
Quelle:
WebClient.cs

Öffnet einen lesbaren Stream für die von einer Ressource mit dem als Uri angegebenen URI heruntergeladenen Daten.

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

Parameter

address
Uri

Der als Uri angegebene URI, von dem Daten heruntergeladen werden.

Gibt zurück

Ein zum Lesen von Daten aus einer Ressource verwendeter Stream.

Ausnahmen

Der address-Parameter ist null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.

- oder -

Fehler beim Herunterladen von Daten.

Hinweise

Die OpenRead -Methode erstellt eine Stream instance, die verwendet wird, um den Inhalt der ressource zu lesen, die durch den address Parameter angegeben wird. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der Methoden, um die Ausführung während des Wartens auf den OpenReadAsync Stream fortzusetzen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI enthält, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Daten zu bilden. Wenn die QueryString Eigenschaft nicht nullist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Gilt für: