Freigeben über

WebClient.OpenRead Methode

Definition

Namespace:
System.Net
Assemblys:
netstandard.dll, System.Net.WebClient.dll
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

Überlädt

Name Beschreibung
OpenRead(String)

Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten, wobei der als URI angegebene URI angegeben ist String.
OpenRead(Uri)

Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten, wobei der als URI angegebene URI angegeben ist Uri.

OpenRead(String)

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

Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten, wobei der als URI angegebene URI angegeben ist 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

Parameter

address
String

Der URI, der als Eine String angegeben wurde, aus der Daten heruntergeladen werden sollen.

Gibt zurück

Stream

Ein Stream Verwendeter Zum Lesen von Daten aus einer Ressource.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddressgebildet wird, address ist ungültig.

-oder-

Fehler beim Herunterladen von Daten.

Beispiele

Im folgenden Codebeispiel wird die identifizierte uriString Ressource geöffnet und die Ergebnisse in der Systemkonsole angezeigt. Das Stream zurückgegebene Element 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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenRead Methode erstellt eine Stream Instanz, die verwendet wird, um den Inhalt der durch den address Parameter angegebenen Ressource zu lesen. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der OpenReadAsync Methoden, um die Ausführung beim Warten auf den Datenstrom fortzusetzen.

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

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

Anmerkung

Sie müssen nach Abschluss des Stream Vorgangs aufrufenStream.Close, um zu vermeiden, dass keine Systemressourcen mehr vorhanden sind.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Gilt für:

OpenRead(Uri)

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

Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten, wobei der als URI angegebene URI angegeben ist 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

Parameter

address
Uri

Der URI, der als Eine Uri angegeben wurde, aus der Daten heruntergeladen werden sollen.

Gibt zurück

Stream

Ein Stream Verwendeter Zum Lesen von Daten aus einer Ressource.

Ausnahmen

ArgumentNullException

Der address Parameter ist null.

WebException

Der URI, der durch Kombinieren BaseAddressgebildet wird, address ist ungültig.

-oder-

Fehler beim Herunterladen von Daten.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Die OpenRead Methode erstellt eine Stream Instanz, die verwendet wird, um den Inhalt der durch den address Parameter angegebenen Ressource zu lesen. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der OpenReadAsync Methoden, um die Ausführung beim Warten auf den Datenstrom fortzusetzen.

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

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

Anmerkung

Sie müssen nach Abschluss des Stream Vorgangs aufrufenStream.Close, um zu vermeiden, dass keine Systemressourcen mehr vorhanden sind.

Anmerkung

Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network Tracing in .NET Framework.

Gilt für: