WebClient.DownloadStringTaskAsync 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.
Downloadt de resource als een String van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| DownloadStringTaskAsync(String) |
Downloadt de resource als een String van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject. |
| DownloadStringTaskAsync(Uri) |
Downloadt de resource als een String van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject. |
DownloadStringTaskAsync(String)
Downloadt de resource als een String van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As String) As Task(Of String)Parameters
- address
- String
De URI van de resource die moet worden gedownload.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix met de gedownloade resource.
- Kenmerken
Uitzonderingen
De address parameter is null.
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
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 gegevensresource is gedownload. De resource wordt asynchroon gedownload met behulp van threadresources die automatisch worden toegewezen vanuit de threadgroep.
Na het downloaden van de resource gebruikt deze methode de codering die is opgegeven in de Encoding eigenschap om de resource te converteren naar een String. Deze methode blokkeert de aanroepende thread niet tijdens het downloaden van de resource.
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 bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, 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.
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Van toepassing op
DownloadStringTaskAsync(Uri)
Downloadt de resource als een String van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)Parameters
- address
- Uri
De URI van de resource die moet worden gedownload.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt. De Result eigenschap op het taakobject retourneert een Byte matrix met de gedownloade resource.
- Kenmerken
Uitzonderingen
De address parameter is null.
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
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 gegevensresource is gedownload. De resource wordt asynchroon gedownload met behulp van threadresources die automatisch worden toegewezen vanuit de threadgroep.
Na het downloaden van de resource gebruikt deze methode de codering die is opgegeven in de Encoding eigenschap om de resource te converteren naar een String. Deze methode blokkeert de aanroepende thread niet tijdens het downloaden van de resource.
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 bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, 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.
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.