WebClient.OpenRead Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ö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
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 Instanz, 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 null
ist, wird sie an address
angefü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
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 Instanz, 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 null
ist, wird sie an address
angefü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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für