WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync WebClient.OpenReadTaskAsync Method

Definition

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.Opens a readable stream containing the specified resource as an asynchronous operation using a task object. Durch diese Methoden wird der aufrufende Thread nicht blockiert.These methods do not block the calling thread.

Überlädt

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String) OpenReadTaskAsync(String)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);
[System.Runtime.InteropServices.ComVisible(false)]
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 String String String

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

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten aus einer Ressource zu lesen.The Result property on the task object returns a Stream used to read data from a resource.

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

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult>-Objekt wird abgeschlossen, nachdem der lesbare Datenstrom für die Daten Ressource geöffnet wurde.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. 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.

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.

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.

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.

Siehe auch

OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri) OpenReadTaskAsync(Uri)

Öffnet einen lesbaren Datenstrom, der die angegebene Ressource als asynchroner Vorgang mithilfe eines Taskobjekts enthält.Opens a readable stream containing the specified resource as an asynchronous operation using a task object.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
[System.Runtime.InteropServices.ComVisible(false)]
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 Uri Uri Uri

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

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.The task object representing the asynchronous operation. Die Result-Eigenschaft im Task-Objekt gibt Stream zurück, das verwendet wird, um Daten aus einer Ressource zu lesen.The Result property on the task object returns a Stream used to read data from a resource.

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

Dieser Vorgang wird nicht blockiert.This operation will not block. Das zurückgegebene Task<TResult>-Objekt wird abgeschlossen, nachdem der lesbare Datenstrom für die Daten Ressource geöffnet wurde.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. 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.

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.

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.

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.

Siehe auch

Gilt für: