WebClient.DownloadStringAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
DownloadStringAsync(Uri) |
Загружает ресурс, указанный как Uri. Этот метод не блокирует вызывающий поток. |
DownloadStringAsync(Uri, Object) |
Загружает указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток. |
DownloadStringAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс, указанный как Uri. Этот метод не блокирует вызывающий поток.
public:
void DownloadStringAsync(Uri ^ address);
public void DownloadStringAsync (Uri address);
member this.DownloadStringAsync : Uri -> unit
Public Sub DownloadStringAsync (address As Uri)
Параметры
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Комментарии
Ресурс загружается асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойстве Encoding , для преобразования ресурса Stringв . Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать его в ожидании ответа сервера, используйте DownloadString метод . После завершения DownloadStringCompleted скачивания возникает событие . Приложение должно обрабатывать это событие, чтобы получать уведомления. Скачанная строка доступна в свойстве Result .
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые еще не завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, должен быть относительным URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных.
QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые DownloadString(Uri).
Применяется к
DownloadStringAsync(Uri, Object)
- Исходный код:
- 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 -> unit
Public Sub DownloadStringAsync (address As Uri, userToken As Object)
Параметры
- userToken
- Object
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Комментарии
Ресурс загружается асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойстве Encoding , для преобразования ресурса Stringв . Этот метод не блокирует вызывающий поток при скачивании ресурса. Чтобы скачать ресурс и заблокировать его в ожидании ответа сервера, используйте DownloadString метод . После завершения DownloadStringCompleted скачивания возникает событие . Приложение должно обрабатывать это событие, чтобы получать уведомления. Скачанная строка доступна в свойстве Result .
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые еще не завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, должен быть относительным URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных.
QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по