WebClient.DownloadDataAsync Metoda

Definicja

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)

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

address
Uri

Identyfikator Uri zawierający identyfikator URI do pobrania.

Wyjątki

Parametr address ma wartość 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 dla protokołu skojarzonego ze schematem identyfikatora URI określonym w pliku address. 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 wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z DownloadData metod. Po zakończeniu pobierania zostanie DownloadDataCompleted 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, aby pobrać zasób 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 ciągiem pustym, jest dołączana do addresselementu .

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

DownloadDataAsync(Uri, Object)

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

address
Uri

Identyfikator Uri zawierający identyfikator URI do pobrania.

userToken
Object

Obiekt zdefiniowany przez użytkownika, który jest przekazywany do metody wywoływanej po zakończeniu operacji asynchronicznej.

Wyjątki

Parametr address ma wartość 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 dla protokołu skojarzonego ze schematem identyfikatora URI określonym w pliku address. 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 wywołującego wątku podczas pobierania zasobu. Aby pobrać zasób i zablokować podczas oczekiwania na odpowiedź serwera, użyj jednej z DownloadData metod. Po zakończeniu pobierania zostanie DownloadDataCompleted 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, aby pobrać zasób 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 ciągiem pustym, jest dołączana do addresselementu .

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