WebClient.DownloadFileAsync 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ą. Te metody nie blokują wątku wywołującego.
Przeciążenia
DownloadFileAsync(Uri, String) |
Pobiera do pliku lokalnego zasób o określonym identyfikatorze URI. Ta metoda nie blokuje wątku wywołującego. |
DownloadFileAsync(Uri, String, Object) |
Pobiera do pliku lokalnego zasób o określonym identyfikatorze URI. Ta metoda nie blokuje wątku wywołującego. |
DownloadFileAsync(Uri, String)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera do pliku lokalnego zasób o określonym identyfikatorze URI. Ta metoda nie blokuje wątku wywołującego.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName);
public void DownloadFileAsync (Uri address, string fileName);
member this.DownloadFileAsync : Uri * string -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String)
Parametry
- address
- Uri
Identyfikator URI zasobu do pobrania.
- fileName
- String
Nazwa pliku, który ma zostać umieszczony na komputerze lokalnym.
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 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. Aby otrzymywać powiadomienia, gdy plik jest dostępny, dodaj do zdarzenia program obsługi zdarzeń DownloadFileCompleted .
Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu. Aby zablokować podczas oczekiwania na ukończenie pobierania, użyj jednej z DownloadFile metod.
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.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez DownloadFile(Uri, String)usługę .
Dotyczy
DownloadFileAsync(Uri, String, Object)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera do pliku lokalnego zasób o określonym identyfikatorze URI. Ta metoda nie blokuje wątku wywołującego.
public:
void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);
public void DownloadFileAsync (Uri address, string fileName, object? userToken);
public void DownloadFileAsync (Uri address, string fileName, object userToken);
member this.DownloadFileAsync : Uri * string * obj -> unit
Public Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)
Parametry
- address
- Uri
Identyfikator URI zasobu do pobrania.
- fileName
- String
Nazwa pliku, który ma zostać umieszczony na komputerze lokalnym.
- userToken
- Object
Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.
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 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. Aby otrzymywać powiadomienia, gdy plik jest dostępny, dodaj do zdarzenia program obsługi zdarzeń DownloadFileCompleted .
Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu. Aby zablokować podczas oczekiwania na ukończenie pobierania, użyj jednej z DownloadFile metod.
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