WebClient.DownloadDataAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция. Эти методы не блокируют вызывающий поток.
Перегрузки
| DownloadDataAsync(Uri) |
Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция. |
| DownloadDataAsync(Uri, Object) |
Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция. |
DownloadDataAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция.
public:
void DownloadDataAsync(Uri ^ address);public void DownloadDataAsync (Uri address);member this.DownloadDataAsync : Uri -> unitPublic Sub DownloadDataAsync (address As Uri)Параметры
Исключения
Параметр addressnull.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция.
public:
void DownloadDataAsync(Uri ^ address, System::Object ^ userToken);public void DownloadDataAsync (Uri address, object? userToken);public void DownloadDataAsync (Uri address, object userToken);member this.DownloadDataAsync : Uri * obj -> unitPublic Sub DownloadDataAsync (address As Uri, userToken As Object)Параметры
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
Параметр addressnull.
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.
