WebClient.OpenRead Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Ö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)

Ö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

Stream

Ein zum Lesen von Daten aus einer Ressource verwendeter Stream.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

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

- oder -

Fehler beim Herunterladen von Daten.

Beispiele

Im folgenden Codebeispiel wird die Ressource geöffnet, die von uriString der Systemkonsole identifiziert wird und die Ergebnisse angezeigt werden. Die Stream zurückgegebene Datei 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 vom address Parameter angegeben wird. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der OpenReadAsync Methoden, um die Ausführung während des Wartens auf den Stream fortzusetzen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keine absolute URI enthält, muss ein relativer URI sein, address der mit BaseAddress dem absoluten URI der angeforderten Daten kombiniert wird. Wenn die QueryString Eigenschaft nicht nullvorhanden ist, wird sie an angefügt address.

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 anrufen Stream.Close , wenn sie mit dem Stream Abschluss abgeschlossen sind, um zu vermeiden, dass Systemressourcen nicht ausgeführt werden.

Hinweis

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

OpenRead(Uri)

Ö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

Stream

Ein zum Lesen von Daten aus einer Ressource verwendeter Stream.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

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 vom address Parameter angegeben wird. Diese Methode blockiert beim Öffnen des Datenstroms. Verwenden Sie eine der OpenReadAsync Methoden, um die Ausführung während des Wartens auf den Stream fortzusetzen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keine absolute URI enthält, muss ein relativer URI sein, address der mit BaseAddress dem absoluten URI der angeforderten Daten kombiniert wird. Wenn die QueryString Eigenschaft nicht nullvorhanden ist, wird sie an angefügt address.

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 anrufen Stream.Close , wenn sie mit dem Stream Abschluss abgeschlossen sind, um zu vermeiden, dass Systemressourcen nicht ausgeführt werden.

Hinweis

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