WebClient.DownloadDataAsync 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 Byte matrix van de URI die is opgegeven als een asynchrone bewerking. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| DownloadDataAsync(Uri) |
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking. |
| DownloadDataAsync(Uri, Object) |
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking. |
DownloadDataAsync(Uri)
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking.
public:
void DownloadDataAsync(Uri ^ address);public void DownloadDataAsync(Uri address);member this.DownloadDataAsync : Uri -> unitPublic Sub DownloadDataAsync (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.
Met deze methode wordt de opgegeven resource opgehaald met behulp van de standaardmethode voor het protocol dat is gekoppeld aan het URI-schema dat is opgegeven in address. De gegevens worden asynchroon gedownload met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
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 een van de DownloadData methoden. Wanneer het downloaden is voltooid, wordt de DownloadDataCompleted gebeurtenis gegenereerd. Uw toepassing moet deze gebeurtenis afhandelen om een melding te ontvangen. De gedownloade gegevens zijn beschikbaar in de Result eigenschap.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.
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.
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 DownloadData(Uri)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
DownloadDataAsync(Uri, Object)
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking.
public:
void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);public void DownloadDataAsync(Uri address, object userToken);member this.DownloadDataAsync : Uri * obj -> unitPublic Sub DownloadDataAsync (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.
Met deze methode wordt de opgegeven resource opgehaald met behulp van de standaardmethode voor het protocol dat is gekoppeld aan het URI-schema dat is opgegeven in address. De gegevens worden asynchroon gedownload met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
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 een van de DownloadData methoden. Wanneer het downloaden is voltooid, wordt de DownloadDataCompleted gebeurtenis gegenereerd. Uw toepassing moet deze gebeurtenis afhandelen om een melding te ontvangen. De gedownloade gegevens zijn beschikbaar in de Result eigenschap.
In .NET Framework kunt u asynchrone bewerkingen annuleren die niet zijn voltooid door de methode CancelAsync aan te roepen.
Deze methode gebruikt de RETR-opdracht om een FTP-resource te downloaden. Voor een HTTP-resource wordt de GET-methode gebruikt.
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.
Note
Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.