WebClient.OpenReadTaskAsync Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält. Durch diese Methoden wird der aufrufende Thread nicht blockiert.

Überlädt

OpenReadTaskAsync(String)	Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.
OpenReadTaskAsync(Uri)	Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.

OpenReadTaskAsync(String)

Quelle:

WebClient.cs

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);

member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Parameter

address

String

Der abzurufende URI der Ressource.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten aus einer Ressource zu lesen.

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

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der lesbare Datenstrom zur Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream Instanz 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.

Hinweis

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

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die 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.

Weitere Informationen

• Stream

OpenReadTaskAsync(Uri)

Quelle:

WebClient.cs

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);

member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Parameter

address

Uri

Der abzurufende URI der Ressource.

Gibt zurück

Task<Stream>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten aus einer Ressource zu lesen.

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

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der lesbare Datenstrom zur Datenressource geöffnet wurde. Diese Methode blockiert den aufrufenden Thread nicht, während der Stream geöffnet wird.

Diese Methode ruft eine Stream Instanz 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.

Hinweis

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

In .NET Framework und .NET Core 1.0 können Sie asynchrone Vorgänge abbrechen, die 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.

Weitere Informationen

• Stream