WebClient.DownloadFileAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Laddar ned den angivna resursen till en lokal fil som en asynkron åtgärd. Dessa metoder blockerar inte den anropande tråden.
Överlagringar
| Name | Description |
|---|---|
| DownloadFileAsync(Uri, String) |
Laddar ned resursen med den angivna URI:n till en lokal fil. Den här metoden blockerar inte den anropande tråden. |
| DownloadFileAsync(Uri, String, Object) |
Laddar ned resursen med den angivna URI:n till en lokal fil. Den här metoden blockerar inte den anropande tråden. |
DownloadFileAsync(Uri, String)
Laddar ned resursen med den angivna URI:n till en lokal fil. Den här metoden blockerar inte den anropande tråden.
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)Parametrar
- address
- Uri
URI:n för resursen som ska laddas ned.
- fileName
- String
Namnet på filen som ska placeras på den lokala datorn.
Undantag
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
Den lokala fil som anges av fileName används av en annan tråd.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här metoden laddar ned resursen vid den URI som anges av i parametern address . När nedladdningen är klar namnges fileName den nedladdade filen på den lokala datorn. Filen laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när filen är tillgänglig lägger du till en händelsehanterare i DownloadFileCompleted händelsen.
Den här metoden blockerar inte den anropande tråden medan resursen laddas ned. Om du vill blockera i väntan på att nedladdningen ska slutföras använder du någon av DownloadFile metoderna.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte anger en absolut URI, address måste den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
När du använder den här metoden på en ASP.NET-sida får du ett felmeddelande om kontot som sidan körs under inte har behörighet att komma åt den lokala filen.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av DownloadFile(Uri, String).
Gäller för
DownloadFileAsync(Uri, String, Object)
Laddar ned resursen med den angivna URI:n till en lokal fil. Den här metoden blockerar inte den anropande tråden.
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)Parametrar
- address
- Uri
URI:n för resursen som ska laddas ned.
- fileName
- String
Namnet på filen som ska placeras på den lokala datorn.
- userToken
- Object
Ett användardefinierat objekt som skickas till metoden som anropas när den asynkrona åtgärden slutförs.
Undantag
Den URI som skapas genom att kombinera BaseAddress och address är ogiltig.
-eller-
Ett fel uppstod när resursen skulle laddas ned.
Den lokala fil som anges av fileName används av en annan tråd.
Kommentarer
Caution
WebRequest, HttpWebRequest, ServicePoint, och WebClient är föråldrade och du bör inte använda dem för ny utveckling. Använd HttpClient i stället.
Den här metoden laddar ned resursen vid den URI som anges av i parametern address . När nedladdningen är klar namnges fileName den nedladdade filen på den lokala datorn. Filen laddas ned asynkront med hjälp av trådresurser som automatiskt allokeras från trådpoolen. Om du vill få ett meddelande när filen är tillgänglig lägger du till en händelsehanterare i DownloadFileCompleted händelsen.
Den här metoden blockerar inte den anropande tråden medan resursen laddas ned. Om du vill blockera i väntan på att nedladdningen ska slutföras använder du någon av DownloadFile metoderna.
I .NET Framework kan du avbryta asynkrona åtgärder som inte har slutförts genom att anropa metoden CancelAsync.
Om egenskapen BaseAddress inte är en tom sträng ("") och address inte anger en absolut URI, address måste den vara en relativ URI som kombineras med BaseAddress för att bilda den absoluta URI:n för begärda data. Om egenskapen QueryString inte är en tom sträng läggs den till addressi .
Den här metoden använder RETR-kommandot för att ladda ned en FTP-resurs. För en HTTP-resurs används GET-metoden.
Note
Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.
När du använder den här metoden på en ASP.NET-sida får du ett felmeddelande om kontot som sidan körs under inte har behörighet att komma åt den lokala filen.