WebClient.DownloadFileAsync 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 opgegeven resource naar een lokaal bestand als een asynchrone bewerking. Deze methoden blokkeren de aanroepende thread niet.
Overloads
| Name | Description |
|---|---|
| DownloadFileAsync(Uri, String) |
Downloadt, naar een lokaal bestand, de resource met de opgegeven URI. Deze methode blokkeert de aanroepende thread niet. |
| DownloadFileAsync(Uri, String, Object) |
Downloadt, naar een lokaal bestand, de resource met de opgegeven URI. Deze methode blokkeert de aanroepende thread niet. |
DownloadFileAsync(Uri, String)
Downloadt, naar een lokaal bestand, de resource met de opgegeven URI. Deze methode blokkeert de aanroepende thread niet.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);public void DownloadFileAsync(Uri address, string fileName);member this.DownloadFileAsync : Uri * string -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String)Parameters
- address
- Uri
De URI van de resource die moet worden gedownload.
- fileName
- String
De naam van het bestand dat op de lokale computer moet worden geplaatst.
Uitzonderingen
De URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
Het lokale bestand dat is opgegeven door fileName een andere thread wordt gebruikt.
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 resource gedownload op de URI die is opgegeven in de address parameter. Wanneer het downloaden is voltooid, krijgt het gedownloade bestand de naam fileName op de lokale computer. Het bestand wordt asynchroon gedownload met thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer het bestand beschikbaar is, voegt u een gebeurtenis-handler toe aan de DownloadFileCompleted gebeurtenis.
Met deze methode wordt de aanroepende thread niet geblokkeerd terwijl de resource wordt gedownload. Als u wilt blokkeren terwijl het downloaden is voltooid, gebruikt u een van de DownloadFile methoden.
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 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.
Wanneer u deze methode op een ASP.NET pagina gebruikt, krijgt u een foutmelding als het account waaronder de pagina wordt uitgevoerd, geen toegang heeft tot het lokale bestand.
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 DownloadFile(Uri, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
DownloadFileAsync(Uri, String, Object)
Downloadt, naar een lokaal bestand, de resource met de opgegeven URI. Deze methode blokkeert de aanroepende thread niet.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);public void DownloadFileAsync(Uri address, string fileName, object userToken);member this.DownloadFileAsync : Uri * string * obj -> unitPublic Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)Parameters
- address
- Uri
De URI van de resource die moet worden gedownload.
- fileName
- String
De naam van het bestand dat op de lokale computer moet worden geplaatst.
- 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 URI die wordt gevormd door combinatie en BaseAddressaddress is ongeldig.
– of –
Er is een fout opgetreden tijdens het downloaden van de resource.
Het lokale bestand dat is opgegeven door fileName een andere thread wordt gebruikt.
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 resource gedownload op de URI die is opgegeven in de address parameter. Wanneer het downloaden is voltooid, krijgt het gedownloade bestand de naam fileName op de lokale computer. Het bestand wordt asynchroon gedownload met thread-resources die automatisch worden toegewezen vanuit de threadgroep. Als u een melding wilt ontvangen wanneer het bestand beschikbaar is, voegt u een gebeurtenis-handler toe aan de DownloadFileCompleted gebeurtenis.
Met deze methode wordt de aanroepende thread niet geblokkeerd terwijl de resource wordt gedownload. Als u wilt blokkeren terwijl het downloaden is voltooid, gebruikt u een van de DownloadFile methoden.
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 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.
Wanneer u deze methode op een ASP.NET pagina gebruikt, krijgt u een foutmelding als het account waaronder de pagina wordt uitgevoerd, geen toegang heeft tot het lokale bestand.