WebClient.DownloadDataTaskAsync Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи. Эти методы не блокируют вызывающий поток.

Перегрузки

DownloadDataTaskAsync(String)	Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.
DownloadDataTaskAsync(Uri)	Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.

DownloadDataTaskAsync(String)

Исходный код:

WebClient.cs

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.

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())

Параметры

address

String

URI загружаемого ресурса.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий загруженный ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

URI, образованный объединением BaseAddress и address, является недопустимым.

-или-

Произошла ошибка при загрузке ресурса.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных.

Этот метод извлекает указанный ресурс с помощью метода по умолчанию для протокола, связанного со схемой URI, указанной в параметре address . Данные загружаются асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.

В следующем примере кода запрашиваются данные с сервера и отображаются возвращенные данные. Предполагается, что remoteUri содержит допустимый URI для запрошенных данных.

DownloadDataTaskAsync(Uri)

Исходный код:

WebClient.cs

Загружает ресурс как массив Byte из URI, указанного как асинхронная операция с помощью объекта задачи.

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())

Параметры

address

Uri

URI загружаемого ресурса.

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий загруженный ресурс.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

URI, образованный объединением BaseAddress и address, является недопустимым.

-или-

Произошла ошибка при загрузке ресурса.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных.

Этот метод извлекает указанный ресурс с помощью метода по умолчанию для протокола, связанного со схемой URI, указанной в параметре address . Данные загружаются асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.