WebClient.DownloadDataTaskAsync 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 met behulp van een taakobject. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| DownloadDataTaskAsync(String) |
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject. |
| DownloadDataTaskAsync(Uri) |
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject. |
DownloadDataTaskAsync(String)
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())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.
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 de address parameter. De gegevens worden asynchroon gedownload met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
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.
In het volgende codevoorbeeld worden gegevens van een server aangevraagd en worden de geretourneerde gegevens weergegeven. Hierbij wordt ervan uitgegaan dat deze remoteUri een geldige URI voor de aangevraagde gegevens bevat.
Van toepassing op
DownloadDataTaskAsync(Uri)
Downloadt de resource als een Byte matrix van de URI die is opgegeven als een asynchrone bewerking met behulp van een taakobject.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())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.
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 de address parameter. De gegevens worden asynchroon gedownload met behulp van thread-resources die automatisch worden toegewezen vanuit de threadgroep.
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.