WebClient.DownloadDataAsync 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 zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna. Te metody nie blokują wątku wywołującego.
Przeciążenia
DownloadDataAsync(Uri) |
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna. |
DownloadDataAsync(Uri, Object) |
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna. |
DownloadDataAsync(Uri)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna.
public:
void DownloadDataAsync(Uri ^ address);
public void DownloadDataAsync (Uri address);
member this.DownloadDataAsync : Uri -> unit
Public Sub DownloadDataAsync (address As Uri)
Parametry
Wyjątki
Parametr address
to null
.
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Uwagi
Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w address
pliku . Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z DownloadData metod. Po zakończeniu pobierania DownloadDataCompleted zostanie zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrane dane są dostępne we Result właściwości.
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 .
Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera 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 address
elementu .
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.
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez DownloadData(Uri)usługę .
Dotyczy
DownloadDataAsync(Uri, Object)
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
- Źródło:
- WebClient.cs
Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna.
public:
void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);
public void DownloadDataAsync (Uri address, object? userToken);
public void DownloadDataAsync (Uri address, object userToken);
member this.DownloadDataAsync : Uri * obj -> unit
Public Sub DownloadDataAsync (address As Uri, userToken As Object)
Parametry
- userToken
- Object
Obiekt zdefiniowany przez użytkownika przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.
Wyjątki
Parametr address
to null
.
Identyfikator URI utworzony przez połączenie BaseAddress i address
jest nieprawidłowy.
-lub-
Wystąpił błąd podczas pobierania zasobu.
Uwagi
Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w address
pliku . Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.
Ta metoda nie blokuje wątku wywołującego podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z DownloadData metod. Po zakończeniu pobierania DownloadDataCompleted zostanie zgłoszone zdarzenie. Aplikacja musi obsługiwać to zdarzenie, aby otrzymywać powiadomienia. Pobrane dane są dostępne we Result właściwości.
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 .
Ta metoda używa polecenia RETR do pobrania zasobu FTP. W przypadku zasobu HTTP jest używana metoda GET.
BaseAddress Jeśli właściwość nie jest pustym ciągiem ("") i address
nie zawiera 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 address
elementu .
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.
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