WebClient.DownloadFileTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.WebClient.dll

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

Nazwa	Opis
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

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);

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

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

InvalidOperationException

Plik lokalny określony fileName przez program jest używany przez inny wątek.

Uwagi

Ostrożność

WebRequest, , HttpWebRequestServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Użyj HttpClient zamiast tego.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt zostanie ukończony Task po pobraniu zasobu danych.

Ta metoda pobiera zasób pod identyfikatorem URI określonym przez 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 programach .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 pustym ciągiem, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

W przypadku korzystania z tej metody na stronie ASP.NET zostanie wyświetlony błąd, jeśli konto wykonywane na stronie nie ma uprawnień dostępu do pliku lokalnego.

DownloadFileTaskAsync(Uri, String)

Ź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);

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

Task

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Parametr address jest null.

-lub-

Parametr fileName jest null.

WebException

Identyfikator URI utworzony przez połączenie BaseAddress i address jest nieprawidłowy.

-lub-

Wystąpił błąd podczas pobierania zasobu.

InvalidOperationException

Plik lokalny określony fileName przez program jest używany przez inny wątek.

Uwagi

Ostrożność

WebRequest, , HttpWebRequestServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Użyj HttpClient zamiast tego.

Ta operacja nie zostanie zablokowana. Zwrócony obiekt zostanie ukończony Task po pobraniu zasobu danych.

Ta metoda pobiera zasób pod identyfikatorem URI określonym przez 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 programach .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 pustym ciągiem, jest dołączana do addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.

Nuta

Ten element członkowski generuje informacje śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w programie .NET Framework.

W przypadku korzystania z tej metody na stronie ASP.NET zostanie wyświetlony błąd, jeśli konto wykonywane na stronie nie ma uprawnień dostępu do pliku lokalnego.