WebClient.OpenReadTaskAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee opent u een leesbare stroom met de opgegeven resource als asynchrone bewerking met behulp van een taakobject. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| OpenReadTaskAsync(String) |
Hiermee opent u een leesbare stroom met de opgegeven resource als asynchrone bewerking met behulp van een taakobject. |
| OpenReadTaskAsync(Uri) |
Hiermee opent u een leesbare stroom met de opgegeven resource als asynchrone bewerking met behulp van een taakobject. |
OpenReadTaskAsync(String)
Hiermee opent u een leesbare stroom met de opgegeven resource als asynchrone bewerking met behulp van een taakobject.
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);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)Parameters
- address
- String
De URI van de resource die moet worden opgehaald.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap van het taakobject retourneert een Stream gebruikt om gegevens uit een resource te lezen.
- Kenmerken
Uitzonderingen
De address parameter is null.
De URI die wordt gevormd door combinatie BaseAddress en adres is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de leesbare stroom naar de gegevensresource is geopend. Deze methode blokkeert de aanroepende thread niet terwijl de stream wordt geopend.
Met deze methode wordt een Stream exemplaar opgehaald dat wordt gebruikt voor toegang tot de resource die is opgegeven door de address parameter. De stream wordt verkregen met behulp van threadresources die automatisch worden toegewezen vanuit de threadgroep.
Note
U moet aanroepen Stream.Close wanneer u klaar bent om Stream te voorkomen dat er geen systeembronnen meer beschikbaar zijn.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI opgeeft, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde resource. Als de QueryString eigenschap niet nullis, wordt deze toegevoegd aan address.
Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Zie ook
Van toepassing op
OpenReadTaskAsync(Uri)
Hiermee opent u een leesbare stroom met de opgegeven resource als asynchrone bewerking met behulp van een taakobject.
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);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)Parameters
- address
- Uri
De URI van de resource die moet worden opgehaald.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap van het taakobject retourneert een Stream gebruikt om gegevens uit een resource te lezen.
- Kenmerken
Uitzonderingen
De address parameter is null.
De URI die wordt gevormd door combinatie BaseAddress en adres is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
– of –
Er is een fout opgetreden tijdens het openen van de stream.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat de leesbare stroom naar de gegevensresource is geopend. Deze methode blokkeert de aanroepende thread niet terwijl de stream wordt geopend.
Met deze methode wordt een Stream exemplaar opgehaald dat wordt gebruikt voor toegang tot de resource die is opgegeven door de address parameter. De stream wordt verkregen met behulp van threadresources die automatisch worden toegewezen vanuit de threadgroep.
Note
U moet aanroepen Stream.Close wanneer u klaar bent om Stream te voorkomen dat er geen systeembronnen meer beschikbaar zijn.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI opgeeft, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde resource. Als de QueryString eigenschap niet nullis, wordt deze toegevoegd aan address.
Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.