WebClient.OpenRead Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

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

Überlädt

OpenRead(String)	Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten mit dem als Stringangegebenen URI.
OpenRead(Uri)	Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten mit dem als Uriangegebenen URI.

OpenRead(String)

Quelle:

WebClient.cs

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

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, aus dem Daten heruntergeladen werden sollen.

Gibt zurück

Stream

Ein Stream zum Lesen von Daten aus einer Ressource verwendet.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination BaseAddress, address gebildet wird, ist ungültig.

-oder-

Fehler beim Herunterladen von Daten.

Beispiele

Im folgenden Codebeispiel wird die durch uriString identifizierte Ressource geöffnet und die Ergebnisse in der Systemkonsole angezeigt. Die von OpenRead zurückgegebene Stream 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 vom address Parameter angegebenen Ressource zu lesen. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenReadAsync Methoden.

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

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 Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

Anmerkung

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

OpenRead(Uri)

Quelle:

WebClient.cs

Öffnet einen lesbaren Datenstrom für die aus einer Ressource heruntergeladenen Daten mit dem als Uriangegebenen 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 als Uri angegebene URI, aus dem Daten heruntergeladen werden sollen.

Gibt zurück

Stream

Ein Stream zum Lesen von Daten aus einer Ressource verwendet.

Ausnahmen

ArgumentNullException

Der parameter address ist null.

WebException

Der URI, der durch die Kombination BaseAddress, address gebildet wird, 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 vom address Parameter angegebenen Ressource zu lesen. Diese Methode blockiert beim Öffnen des Datenstroms. Wenn Sie weiterhin auf den Datenstrom warten möchten, verwenden Sie eine der OpenReadAsync Methoden.

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

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 Stream.Close aufrufen, wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass Systemressourcen nicht mehr vorhanden sind.

Anmerkung

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