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 operację asynchroniczną 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 operację asynchroniczną przy użyciu obiektu zadania.
DownloadDataTaskAsync(Uri)	Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną przy użyciu obiektu zadania.

DownloadDataTaskAsync(String)

Źródło:

WebClient.cs

Pobiera zasób jako tablicę Byte z identyfikatora URI określonego jako operację asynchroniczną 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ę zawierającą Byte pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

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

-lub-

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

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> 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.

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 addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu 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.

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 operację asynchroniczną 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ę zawierającą Byte pobrany zasób.

Wyjątki

ArgumentNullException

Parametr address to null.

WebException

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

-lub-

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

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> 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.

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 addresselementu .

Ta metoda używa polecenia RETR do pobrania zasobu 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.