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 -> unit
Public Sub DownloadDataAsync (address As Uri)
Параметры
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- 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 -> unit
Public Sub DownloadDataAsync (address As Uri, userToken As Object)
Параметры
- userToken
- Object
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
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.
Применяется к
Кері байланыс
https://aka.ms/ContentUserFeedback.
Жақында қолжетімді болады: 2024 жыл бойы біз GitHub Issues жүйесін мазмұнға арналған кері байланыс механизмі ретінде біртіндеп қолданыстан шығарамыз және оны жаңа кері байланыс жүйесімен ауыстырамыз. Қосымша ақпаратты мұнда қараңыз:Жіберу және пікірді көру