WebClient.DownloadStringAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| DownloadStringAsync(Uri) |
Скачивает ресурс, указанный Uriв качестве. Этот метод не блокирует вызывающий поток. |
| DownloadStringAsync(Uri, Object) |
Загружает указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток. |
DownloadStringAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Скачивает ресурс, указанный Uriв качестве. Этот метод не блокирует вызывающий поток.
public:
void DownloadStringAsync(Uri ^ address);public void DownloadStringAsync(Uri address);member this.DownloadStringAsync : Uri -> unitPublic Sub DownloadStringAsync (address As Uri)Параметры
Исключения
Параметр address имеет значение null.
URI, сформированный BaseAddress объединением и address недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.
Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать при ожидании ответа сервера, используйте DownloadString этот метод. Когда скачивание завершится, DownloadStringCompleted событие вызывается. Приложение должно обрабатывать это событие для получения уведомлений. Скачанная строка доступна в свойстве Result .
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных.
QueryString Если свойство не является пустой строкой, она добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых DownloadString(Uri).
Применяется к
DownloadStringAsync(Uri, Object)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);public void DownloadStringAsync(Uri address, object? userToken);public void DownloadStringAsync(Uri address, object userToken);member this.DownloadStringAsync : Uri * obj -> unitPublic Sub DownloadStringAsync (address As Uri, userToken As Object)Параметры
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
Параметр address имеет значение null.
URI, сформированный BaseAddress объединением и address недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.
Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать при ожидании ответа сервера, используйте DownloadString этот метод. Когда скачивание завершится, DownloadStringCompleted событие вызывается. Приложение должно обрабатывать это событие для получения уведомлений. Скачанная строка доступна в свойстве Result .
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных.
QueryString Если свойство не является пустой строкой, она добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.
