WebClient.DownloadStringAsync 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.
Overloads
| Name | Description |
|---|---|
| DownloadStringAsync(Uri) |
Downloadt de resource die is opgegeven als een Uri. Deze methode blokkeert de aanroepende thread niet. |
| DownloadStringAsync(Uri, Object) |
Hiermee downloadt u de opgegeven tekenreeks naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet. |
DownloadStringAsync(Uri)
Downloadt de resource die is opgegeven als een Uri. Deze methode blokkeert de aanroepende thread niet.
public:
void DownloadStringAsync(Uri ^ address);public void DownloadStringAsync(Uri address);member this.DownloadStringAsync : Uri -> unitPublic Sub DownloadStringAsync (address As Uri)Parameters
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.
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. Als u een resource wilt downloaden en blokkeren terwijl u wacht op het antwoord van de server, gebruikt u de DownloadString methode. Wanneer het downloaden is voltooid, wordt de DownloadStringCompleted gebeurtenis gegenereerd. Uw toepassing moet deze gebeurtenis afhandelen om een melding te ontvangen. De gedownloade tekenreeks is beschikbaar in de Result eigenschap.
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.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door DownloadString(Uri)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
DownloadStringAsync(Uri, Object)
Hiermee downloadt u de opgegeven tekenreeks naar de opgegeven resource. Deze methode blokkeert de aanroepende thread niet.
public:
void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);public void DownloadStringAsync(Uri address, object userToken);member this.DownloadStringAsync : Uri * obj -> unitPublic Sub DownloadStringAsync (address As Uri, userToken As Object)Parameters
- userToken
- Object
Een door de gebruiker gedefinieerd object dat wordt doorgegeven aan de methode die wordt aangeroepen wanneer de asynchrone bewerking is voltooid.
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.
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. Als u een resource wilt downloaden en blokkeren terwijl u wacht op het antwoord van de server, gebruikt u de DownloadString methode. Wanneer het downloaden is voltooid, wordt de DownloadStringCompleted gebeurtenis gegenereerd. Uw toepassing moet deze gebeurtenis afhandelen om een melding te ontvangen. De gedownloade tekenreeks is beschikbaar in de Result eigenschap.
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.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.