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 ab, die für den Zugriff auf die durch den address-Parameter angegebene Ressource verwendet wird.This method retrieves a Stream instance used to access the resource specified by the address parameter. Der Stream wird mithilfe von Thread Ressourcen abgerufen, die automatisch aus dem Thread Pool zugewiesen werden.The stream is obtained using thread resources that are automatically allocated from the thread pool. Um eine Benachrichtigung zu erhalten, wenn der Stream verfügbar ist, fügen Sie dem OpenReadCompleted-Ereignis einen Ereignishandler hinzu.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Hinweis

Wenn Sie die Stream abgeschlossen haben, müssen Sie Stream.Close anrufen, um zu vermeiden, dass die Systemressourcen nicht mehr genügend Systemressourcen benötigen.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.This method does not block the calling thread while the stream is opening. Verwenden Sie die OpenReadAsync-Methode, um zu blockieren, während Sie auf den Stream warten.To block while waiting for the stream, use the OpenReadAsync method.

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

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Ressource zu bilden.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 nicht null ist, wird Sie an address angehängt.If the QueryString property is not null, it is appended to address.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen.This method uses the RETR command to download an FTP resource. Bei einer 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 Netzwerk Ablauf Verfolgung in der .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 ab, die für den Zugriff auf die durch den address-Parameter angegebene Ressource verwendet wird.This method retrieves a Stream instance used to access the resource specified by the address parameter. Der Stream wird mithilfe von Thread Ressourcen abgerufen, die automatisch aus dem Thread Pool zugewiesen werden.The stream is obtained using thread resources that are automatically allocated from the thread pool. Um eine Benachrichtigung zu erhalten, wenn der Stream verfügbar ist, fügen Sie dem OpenReadCompleted-Ereignis einen Ereignishandler hinzu.To receive notification when the stream is available, add an event handler to the OpenReadCompleted event.

Hinweis

Wenn Sie die Stream abgeschlossen haben, müssen Sie Stream.Close anrufen, um zu vermeiden, dass die Systemressourcen nicht mehr genügend Systemressourcen benötigen.You must call Stream.Close when you are finished with the Stream to avoid running out of system resources.

Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.This method does not block the calling thread while the stream is opening. Verwenden Sie die OpenRead-Methode, um zu blockieren, während Sie auf den Stream warten.To block while waiting for the stream, use the OpenRead method.

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

Wenn die BaseAddress-Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss address ein relativer URI sein, der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Ressource zu bilden.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 nicht null ist, wird Sie an address angehängt.If the QueryString property is not null, it is appended to address.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen.This method uses the RETR command to download an FTP resource. Bei einer 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 Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: