WebClient.DownloadDataAsync Метод

Определение

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

System.Net

Сборка:

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, является недопустимым.

-или-

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

Комментарии

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

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с 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, является недопустимым.

-или-

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

Комментарии

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

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

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

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

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

Примечание

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