Поделиться через


HttpClient.TryGetStringAsync(Uri) Метод

Определение

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

public:
 virtual IAsyncOperationWithProgress<HttpGetStringResult ^, HttpProgress> ^ TryGetStringAsync(Uri ^ uri) = TryGetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpGetStringResult, HttpProgress> TryGetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpGetStringResult,HttpProgress> TryGetStringAsync(System.Uri uri);
function tryGetStringAsync(uri)
Public Function TryGetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpGetStringResult, HttpProgress)

Параметры

uri
Uri Uri

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

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

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

Атрибуты

Требования к Windows

Семейство устройств
Windows 10, version 1903 (появилось в 10.0.18362.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v8.0)

Комментарии

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

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

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

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