WebClient.DownloadDataAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

Имя	Описание
DownloadDataAsync(Uri)	Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция.
DownloadDataAsync(Uri, Object)	Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция.

DownloadDataAsync(Uri)

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

WebClient.cs

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

public:
 void DownloadDataAsync(Uri ^ address);

public void DownloadDataAsync(Uri address);

member this.DownloadDataAsync : Uri -> unit

Public Sub DownloadDataAsync (address As Uri)

Параметры

address

Uri

Содержащий Uri URI для скачивания.

Исключения

ArgumentNullException

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

WebException

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

-или-

Произошла ошибка при скачивании ресурса.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать время ожидания ответа сервера, используйте один из DownloadData методов. Когда скачивание завершится, DownloadDataCompleted событие вызывается. Приложение должно обрабатывать это событие для получения уведомлений. Скачанные данные доступны в свойстве Result .

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

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

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

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых DownloadData(Uri).

DownloadDataAsync(Uri, Object)

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

WebClient.cs

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

public:
 void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadDataAsync(Uri address, object? userToken);

member this.DownloadDataAsync : Uri * obj -> unit

Public Sub DownloadDataAsync (address As Uri, userToken As Object)

Параметры

address

Uri

Содержащий Uri URI для скачивания.

userToken

Object

Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.

Исключения

ArgumentNullException

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

WebException

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

-или-

Произошла ошибка при скачивании ресурса.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

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

Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать время ожидания ответа сервера, используйте один из DownloadData методов. Когда скачивание завершится, DownloadDataCompleted событие вызывается. Приложение должно обрабатывать это событие для получения уведомлений. Скачанные данные доступны в свойстве Result .

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

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

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

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.