WebClient.OpenReadAsync WebClient.OpenReadAsync WebClient.OpenReadAsync WebClient.OpenReadAsync Method

Definition

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält.Opens a readable stream containing the specified resource. Durch diese Methoden wird der aufrufende Thread nicht blockiert.These methods do not block the calling thread.

Überlädt

OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri)

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält.Opens a readable stream containing the specified resource. Durch diese Methode wird der aufrufende Thread nicht blockiert.This method does not block the calling thread.

OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object)

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält.Opens a readable stream containing the specified resource. Durch diese Methode wird der aufrufende Thread nicht blockiert.This method does not block the calling thread.

OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri) OpenReadAsync(Uri)

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält.Opens a readable stream containing the specified resource. Durch diese Methode wird der aufrufende Thread nicht blockiert.This method does not block the calling thread.

public:
 void OpenReadAsync(Uri ^ address);
public void OpenReadAsync (Uri address);
member this.OpenReadAsync : Uri -> unit
Public Sub OpenReadAsync (address As Uri)

Parameter

address
Uri Uri Uri Uri

Der abzurufende URI der Ressource.The URI of the resource to retrieve.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Fehler beim Herunterladen der Ressource.An error occurred while downloading the resource.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Hinweise

Diese Methode ruft eine Stream Instanz verwendet, um Zugriff auf die Ressource, die gemäß der address Parameter.This method retrieves a Stream instance used to access the resource specified by the address parameter. Der Stream wird mit Thread-Ressourcen, die automatisch zugewiesen werden, aus dem Threadpool abgerufen.The stream is obtained using thread resources that are automatically allocated from the thread pool. Fügen Sie einen Ereignishandler hinzu, um benachrichtigt zu werden, wenn der Stream verfügbar ist, die OpenReadCompleted Ereignis.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Hinweis

Rufen Sie Stream.Close werden mit der Stream genügend Systemressourcen zu vermeiden.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Diese Methode wird den aufrufenden Thread nicht blockiert, während der Stream geöffnet ist.This method does not block the calling thread while the stream is opening. Beim Warten auf des Streams blockieren, verwenden Sie die OpenReadAsync Methode.To block while waiting for the stream, use the OpenReadAsync method.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address gibt kein absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Ressource zu erstellen.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. Wenn die QueryString Eigenschaft ist nicht null, wird dieser an angefügt address.If the QueryString property is not null, it is appended to address.

Diese Methode verwendet den RETR-Befehl zum Herunterladen einer FTP-Ressource.This method uses the RETR command to download an FTP resource. Für eine HTTP-Ressource wird die GET-Methode verwendet.For an HTTP resource, the GET method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object) OpenReadAsync(Uri, Object)

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält.Opens a readable stream containing the specified resource. Durch diese Methode wird der aufrufende Thread nicht blockiert.This method does not block the calling thread.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);
public void OpenReadAsync (Uri address, object userToken);
member this.OpenReadAsync : Uri * obj -> unit
Public Sub OpenReadAsync (address As Uri, userToken As Object)

Parameter

address
Uri Uri Uri Uri

Der abzurufende URI der Ressource.The URI of the resource to retrieve.

userToken
Object Object Object Object

Ein benutzerdefiniertes Objekt, das bei Abschluss des asynchronen Vorgangs an die aufgerufene Methode übergeben wird.A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Der durch Kombinieren von BaseAddress und address gebildete URI ist ungültig.The URI formed by combining BaseAddress and address is invalid.

- oder --or- Fehler beim Herunterladen der Ressource.An error occurred while downloading the resource.

- oder --or- Fehler beim Öffnen des Streams.An error occurred while opening the stream.

Hinweise

Diese Methode ruft eine Stream Instanz verwendet, um Zugriff auf die Ressource, die gemäß der address Parameter.This method retrieves a Stream instance used to access the resource specified by the address parameter. Der Stream wird mit Thread-Ressourcen, die automatisch zugewiesen werden, aus dem Threadpool abgerufen.The stream is obtained using thread resources that are automatically allocated from the thread pool. Fügen Sie einen Ereignishandler hinzu, um benachrichtigt zu werden, wenn der Stream verfügbar ist, die OpenReadCompleted Ereignis.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Hinweis

Rufen Sie Stream.Close werden mit der Stream genügend Systemressourcen zu vermeiden.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Diese Methode wird den aufrufenden Thread nicht blockiert, während der Stream geöffnet ist.This method does not block the calling thread while the stream is opening. Beim Warten auf des Streams blockieren, verwenden Sie die OpenRead Methode.To block while waiting for the stream, use the OpenRead method.

Asynchrone Vorgänge, die nicht abgeschlossen wurden können abgebrochen werden, mithilfe der CancelAsync Methode.Asynchronous operations that have not completed can be canceled using the CancelAsync method.

Wenn die BaseAddress Eigenschaft handelt es sich nicht um eine leere Zeichenfolge ("") und address gibt kein absoluten URI, address muss ein relativer URI, der in Kombination BaseAddress um den absoluten URI der angeforderten Ressource zu erstellen.If the BaseAddress property is not an empty string ("") and address does not specify an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested resource. Wenn die QueryString Eigenschaft ist nicht null, wird dieser an angefügt address.If the QueryString property is not null, it is appended to address.

Diese Methode verwendet den RETR-Befehl zum Herunterladen einer FTP-Ressource.This method uses the RETR command to download an FTP resource. Für eine HTTP-Ressource wird die GET-Methode verwendet.For an HTTP resource, the GET method is used.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: