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 die ein lesbarer Stream für die Datenressource geöffnet wurde.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. 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.

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.

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.

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.

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 die ein lesbarer Stream für die Datenressource geöffnet wurde.The returned Task<TResult> object will complete after the a readable stream to the data resource has been opened. 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.

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.

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.

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.

Siehe auch

Gilt für: