WebClient.DownloadDataTaskAsync Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebClient.dll

Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania. Te metody nie blokują wątku wywołującego.

Przeciążenia

DownloadDataTaskAsync(String)	Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.
DownloadDataTaskAsync(Uri)	Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

DownloadDataTaskAsync(String)

Źródło:

WebClient.cs

Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (string address);

member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())

Parametry

address

String

Identyfikator URI zasobu do pobrania.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

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

-lub-

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

Uwagi

Ostrożność

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

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

Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w parametrze address. Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

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.

Poniższy przykład kodu żąda danych z serwera i wyświetla zwrócone dane. Przyjęto założenie, że remoteUri zawiera prawidłowy identyfikator URI dla żądanych danych.

DownloadDataTaskAsync(Uri)

Źródło:

WebClient.cs

Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operacja asynchroniczna przy użyciu obiektu zadania.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync (Uri address);

member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())

Parametry

address

Uri

Identyfikator URI zasobu do pobrania.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną. Właściwość Result obiektu zadania zwraca tablicę Byte zawierającą pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address jest null.

WebException

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

-lub-

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

Uwagi

Ostrożność

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

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

Ta metoda pobiera określony zasób przy użyciu domyślnej metody protokołu skojarzonego ze schematem identyfikatora URI określonego w parametrze address. Dane są pobierane asynchronicznie przy użyciu zasobów wątków, które są automatycznie przydzielane z puli wątków.

Jeśli właściwość BaseAddress nie jest pustym ciągiem ("") i address nie zawiera bezwzględnego identyfikatora URI, address musi być względnym identyfikatorem URI połączonym z BaseAddress, aby utworzyć bezwzględny identyfikator URI żądanych danych. Jeśli właściwość QueryString nie jest pustym ciągiem, jest dołączana do address.

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.