WebClient.DownloadStringAsync Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

Загружает указанный ресурс в качестве строки String или Uri. Эти методы не блокируют вызывающий поток.

Перегрузки

DownloadStringAsync(Uri)	Загружает ресурс, указанный как Uri. Этот метод не блокирует вызывающий поток.
DownloadStringAsync(Uri, Object)	Загружает указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

DownloadStringAsync(Uri)

Исходный код:

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

Uri

Uri, в котором содержится URI загрузки.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

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

Загружает указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

public:
 void DownloadStringAsync(Uri ^ address, System::Object ^ userToken);

public void DownloadStringAsync (Uri address, object? userToken);

member this.DownloadStringAsync : Uri * obj -> unit

Public Sub DownloadStringAsync (address As Uri, userToken As Object)

Параметры

address

Uri

Uri, в котором содержится URI загрузки.

userToken

Object

Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

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.