HttpClient.GetStringAsync(Uri) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправка запроса 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)Параметры
Возвращаемое значение
IAsyncOperationWithProgress<Platform::String,HttpProgress>
IAsyncOperationWithProgress<winrt::hstring,HttpProgress>
Объект , представляющий асинхронную операцию.
- Атрибуты
Комментарии
Эта операция не блокируется. Возвращенный объект 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-сервера) могут произойти в любое время. В результате таких ошибок создаются исключения. Если приложение не обрабатывается, исключение может привести к завершению всего приложения средой выполнения. Дополнительные сведения об обработке исключений см. в разделе Обработка исключений в сетевых приложениях.