WebClient.DownloadFileTaskAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera określony zasób do pliku lokalnego jako operację asynchroniczną przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.
Przeciążenia
DownloadFileTaskAsync(String, String) |
Pobiera określony zasób do pliku lokalnego jako operację asynchroniczną przy użyciu obiektu zadania. |
DownloadFileTaskAsync(Uri, String) |
Pobiera określony zasób do pliku lokalnego jako operację asynchroniczną przy użyciu obiektu zadania. |
DownloadFileTaskAsync(String, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera określony zasób do pliku lokalnego jako operację asynchroniczną przy użyciu obiektu zadania.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task
Parametry
- address
- String
Identyfikator URI zasobu do pobrania.
- fileName
- String
Nazwa pliku, który ma zostać umieszczony na komputerze lokalnym.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
- Atrybuty
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Plik lokalny określony przez fileName
program jest używany przez inny wątek.
Uwagi
Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task po pobraniu zasobu danych.
Ta metoda pobiera zasób pod identyfikatorem URI określonym w parametrze address
. Po pomyślnym zakończeniu pobierania pobrany plik ma nazwę fileName
na komputerze lokalnym. Plik jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie określa bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.
W przypadku używania tej metody na stronie ASP.NET zostanie wyświetlony błąd, jeśli konto, na którym jest wykonywana strona, nie ma uprawnień dostępu do pliku lokalnego.
Dotyczy
DownloadFileTaskAsync(Uri, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera określony zasób do pliku lokalnego jako operację asynchroniczną przy użyciu obiektu zadania.
public:
System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task
Parametry
- address
- Uri
Identyfikator URI zasobu do pobrania.
- fileName
- String
Nazwa pliku, który ma zostać umieszczony na komputerze lokalnym.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
- Atrybuty
Wyjątki
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Plik lokalny określony przez fileName
program jest używany przez inny wątek.
Uwagi
Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task po pobraniu zasobu danych.
Ta metoda pobiera zasób pod identyfikatorem URI określonym w parametrze address
. Po pomyślnym zakończeniu pobierania pobrany plik ma nazwę fileName
na komputerze lokalnym. Plik jest pobierany asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
W .NET Framework i .NET Core 1.0 można anulować operacje asynchroniczne, które nie zostały ukończone, wywołując metodę CancelAsync .
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie określa bezwzględnego identyfikatora URI, musi być względnym identyfikatorem URI połączonym address
z BaseAddress w celu utworzenia bezwzględnego identyfikatora URI żądanych danych. QueryString Jeśli właściwość nie jest ciągiem pustym, jest dołączana do address
elementu .
Ta metoda używa polecenia RETR, aby pobrać zasób FTP. W przypadku zasobu HTTP jest używana metoda GET.
Uwaga
Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.
W przypadku używania tej metody na stronie ASP.NET zostanie wyświetlony błąd, jeśli konto, na którym jest wykonywana strona, nie ma uprawnień dostępu do pliku lokalnego.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla