WebClient.OpenReadAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methoden wird der aufrufende Thread nicht blockiert.

Überlädt

OpenReadAsync(Uri)	Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.
OpenReadAsync(Uri, Object)	Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.

OpenReadAsync(Uri)

Quelle:

WebClient.cs

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync (Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

Parameter

address

Uri

Der abzurufende URI der Ressource.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

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

- oder -

Fehler beim Herunterladen der Ressource.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Diese Methode ruft eine Stream instance ab, die für den Zugriff auf die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden. Um Benachrichtigungen zu erhalten, wenn der Stream verfügbar ist, fügen Sie dem OpenReadCompleted Ereignis einen Ereignishandler hinzu.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird. Verwenden Sie die -Methode, um das Warten auf den OpenReadAsync Stream zu blockieren.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Ressource zu bilden. Wenn die QueryString Eigenschaft nicht nullist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

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

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten OpenRead(Uri)Ausnahmen.

OpenReadAsync(Uri, Object)

Quelle:

WebClient.cs

Öffnet einen lesbaren Stream, der die angegebene Ressource enthält. Durch diese Methode wird der aufrufende Thread nicht blockiert.

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

Der abzurufende URI der Ressource.

userToken

Object

Ein benutzerdefiniertes Objekt, das bei Abschluss des asynchronen Vorgangs an die aufgerufene Methode übergeben wird.

Ausnahmen

ArgumentNullException

Der address-Parameter ist null.

WebException

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

- oder -

Fehler beim Herunterladen der Ressource.

- oder -

Fehler beim Öffnen des Streams.

Hinweise

Diese Methode ruft eine Stream instance ab, die für den Zugriff auf die durch den address Parameter angegebene Ressource verwendet wird. Der Stream wird mithilfe von Threadressourcen abgerufen, die automatisch aus dem Threadpool zugeordnet werden. Um Benachrichtigungen zu erhalten, wenn der Stream verfügbar ist, fügen Sie dem OpenReadCompleted Ereignis einen Ereignishandler hinzu.

Hinweis

Sie müssen aufrufen Stream.Close , wenn Sie mit dem Stream fertig sind, um zu vermeiden, dass die Systemressourcen knapp werden.

Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird. Verwenden Sie die -Methode, um das Warten auf den OpenRead Stream zu blockieren.

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die noch nicht abgeschlossen wurden, indem Sie die CancelAsync -Methode aufrufen.

Wenn die BaseAddress Eigenschaft keine leere Zeichenfolge ("") ist und address keinen absoluten URI angibt, muss es sich um einen relativen URI handeln, address der mit BaseAddress kombiniert wird, um den absoluten URI der angeforderten Ressource zu bilden. Wenn die QueryString Eigenschaft nicht nullist, wird sie an addressangefügt.

Diese Methode verwendet den RETR-Befehl, um eine FTP-Ressource herunterzuladen. Für eine HTTP-Ressource wird die GET-Methode verwendet.

Hinweis

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