WebClient.DownloadStringTaskAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

Загружает ресурс в виде String ресурса из URI, указанного как асинхронная операция с помощью объекта задачи. Эти методы не блокируют вызывающий поток.

Перегрузки

Имя	Описание
DownloadStringTaskAsync(String)	Загружает ресурс в виде String ресурса из URI, указанного как асинхронная операция с помощью объекта задачи.
DownloadStringTaskAsync(Uri)	Загружает ресурс в виде String ресурса из URI, указанного как асинхронная операция с помощью объекта задачи.

DownloadStringTaskAsync(String)

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

WebClient.cs

Загружает ресурс в виде String ресурса из URI, указанного как асинхронная операция с помощью объекта задачи.

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);

member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As String) As Task(Of String)

Параметры

address

String

Универсальный код ресурса для скачивания.

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Byte массив, содержащий скачанный ресурс.

Исключения

ArgumentNullException

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

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

Произошла ошибка при скачивании ресурса.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных. Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

После скачивания ресурса этот метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод не блокирует вызывающий поток при скачивании ресурса.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

DownloadStringTaskAsync(Uri)

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

WebClient.cs

Загружает ресурс в виде String ресурса из URI, указанного как асинхронная операция с помощью объекта задачи.

public:
 System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);

member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)

Параметры

address

Uri

Универсальный код ресурса для скачивания.

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Byte массив, содержащий скачанный ресурс.

Исключения

ArgumentNullException

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

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

Произошла ошибка при скачивании ресурса.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных. Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

После скачивания ресурса этот метод использует кодировку, указанную в свойствеEncoding, для преобразования ресурса в .String Этот метод не блокирует вызывающий поток при скачивании ресурса.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.