WebClient.DownloadStringTaskAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает ресурс в виде String из URI, указанного как асинхронная операция с помощью объекта задачи. Эти методы не блокируют вызывающий поток.
Перегрузки
| DownloadStringTaskAsync(String) |
Загружает ресурс в виде String из URI, указанного как асинхронная операция с помощью объекта задачи. |
| DownloadStringTaskAsync(Uri) |
Загружает ресурс в виде String из URI, указанного как асинхронная операция с помощью объекта задачи. |
DownloadStringTaskAsync(String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде String из URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (string address);member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As String) As Task(Of String)Параметры
- address
- String
Универсальный код ресурса для скачивания.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий скачанный ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после скачивания ресурса данных. Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойстве Encoding, для преобразования ресурса в String. Этот метод не блокирует вызывающий поток при скачивании ресурса.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
DownloadStringTaskAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде String из URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync (Uri address);member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)Параметры
- address
- Uri
Универсальный код ресурса для скачивания.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий скачанный ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после скачивания ресурса данных. Ресурс загружается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
После скачивания ресурса этот метод использует кодировку, указанную в свойстве Encoding, для преобразования ресурса в String. Этот метод не блокирует вызывающий поток при скачивании ресурса.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
