HttpClient.GetStringAsync(Uri) Метод

  • Ссылка

Определение

Пространство имен:
Windows.Web.Http
Изменить

Отправка запроса GET согласно указанному универсальному коду ресурса (URI) и возврат текста ответа в виде строки в асинхронной операции. Рекомендации по программированию для класса HttpClient и примеры кода см. в разделе Основные сведения о HttpClient .

public:
 virtual IAsyncOperationWithProgress<Platform::String ^, HttpProgress> ^ GetStringAsync(Uri ^ uri) = GetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<winrt::hstring, HttpProgress> GetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<string,HttpProgress> GetStringAsync(System.Uri uri);
function getStringAsync(uri)
Public Function GetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of String, HttpProgress)

Параметры

uri
Uri Uri

Универсальный код ресурса (URI), по которому отправляется запрос.

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

IAsyncOperationWithProgress<String,HttpProgress>

IAsyncOperationWithProgress<Platform::String,HttpProgress>

IAsyncOperationWithProgress<winrt::hstring,HttpProgress>

Объект , представляющий асинхронную операцию.

Атрибуты
RemoteAsyncAttribute

Комментарии

Эта операция не блокируется. Возвращенный объект IAsyncOperationWithProgress (string и HttpProgress) завершается после считывания всего текста ответа.

Класс HttpClient часто используется приложением для скачивания и последующего анализа текста. Возможно, кодировка символов, указанная в заголовке Content-Type НА HTTP-сервере , не соответствует кодировке символов текста HTTP-ответа (например, XML-кодировка в XML-документе). Один из способов использования HttpClient с текстом — вызвать метод GetStringAsync и передать возвращенную строку в средство синтаксического анализа текста. Однако это может привести к ошибкам, если Content-Type не является типом, выраженным в виде строки. Надежный способ использования HttpClient с анализатором XML — вызвать метод GetBufferAsync и проанализировать буфер для элемента "<?xml>". Затем используйте указанную кодировку символов ("<xmlversion="1.0" encoding="UTF-8"?>", например), чтобы проанализировать текст http-ответа. Для других текстовых форматов можно использовать аналогичные методы, когда приложение сканирует начальную часть текста HTTP-ответа для определения используемой кодировки символов.

Ниже приведены исключения, создаваемые этой функцией.

E_INVALIDARG

Параметр URI был пустой ссылкой (Nothing в Visual Basic).

Обработка исключений.

При вызове этого метода необходимо написать код для обработки исключений. Исключения могут возникать из-за ошибок проверки параметров, ошибок разрешения имен и сетевых ошибок. Исключения из сетевых ошибок (например, потеря подключения, сбои подключения и сбои HTTP-сервера) могут произойти в любое время. В результате таких ошибок создаются исключения. Если приложение не обрабатывается, исключение может привести к завершению всего приложения средой выполнения. Дополнительные сведения об обработке исключений см. в разделе Обработка исключений в сетевых приложениях.

Применяется к

См. также раздел