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


HttpClient.GetStringAsync Метод

Определение

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

Перегрузки

GetStringAsync(String)

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

GetStringAsync(Uri)

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

GetStringAsync(String, CancellationToken)

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

GetStringAsync(Uri, CancellationToken)

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

Комментарии

Эта операция не блокируется.

GetStringAsync(String)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);
member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String) As Task(Of String)

Параметры

requestUri
String

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

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

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

Исключения

requestUri должен быть абсолютным URI или необходимо задать BaseAddress.

Не удалось выполнить запрос из-за ключевой проблемы, например проблемы с подключением к сети, ошибки DNS или ошибки проверки сертификата сервера (или времени ожидания только для .NET Framework).

Только .NET Core и .NET 5 и более поздних версий. Запрос завершился сбоем из-за истечения времени ожидания.

Предоставленный URI запроса не является допустимым относительным или абсолютным URI.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего текста ответа.

Примечание

В случае истечения времени ожидания:

  • платформа .NET Framework вызывает исключение HttpRequestException.
  • .NET Core создает исключение без каких-либо внутренних исключений TaskCanceledException .
  • В .NET 5 и более поздних версиях создается TaskCanceledException объект , который вложен в TimeoutException.

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

GetStringAsync(Uri)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);
member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri) As Task(Of String)

Параметры

requestUri
Uri

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

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

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

Исключения

requestUri должен быть абсолютным URI или необходимо задать BaseAddress.

Не удалось выполнить запрос из-за ключевой проблемы, например проблемы с подключением к сети, ошибки DNS или ошибки проверки сертификата сервера (или времени ожидания только для .NET Framework).

Только .NET Core и .NET 5 и более поздних версий. Запрос завершился сбоем из-за истечения времени ожидания.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего текста ответа.

Примечание

В случае истечения времени ожидания:

  • платформа .NET Framework вызывает исключение HttpRequestException.
  • .NET Core создает исключение без каких-либо внутренних исключений TaskCanceledException .
  • В .NET 5 и более поздних версиях создается TaskCanceledException объект , который вложен в TimeoutException.

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

GetStringAsync(String, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)

Параметры

requestUri
String

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

cancellationToken
CancellationToken

Токен отмены для отмены операции.

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

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

Исключения

Значение параметра requestUrinull.

Не удалось выполнить запрос из-за ключевой проблемы, например проблемы с подключением к сети, ошибки DNS или ошибки проверки сертификата сервера (или времени ожидания только для .NET Framework).

Только .NET Core и .NET 5 и более поздних версий. Запрос завершился сбоем из-за истечения времени ожидания.

Предоставленный URI запроса не является допустимым относительным или абсолютным URI.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего текста ответа.

Примечание

В случае истечения времени ожидания:

  • платформа .NET Framework вызывает исключение HttpRequestException.
  • .NET Core создает исключение без каких-либо внутренних исключений TaskCanceledException .
  • В .NET 5 и более поздних версиях создается TaskCanceledException объект , который вложен в TimeoutException.

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

GetStringAsync(Uri, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

Параметры

requestUri
Uri

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

cancellationToken
CancellationToken

Токен отмены для отмены операции.

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

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

Исключения

Значение параметра requestUrinull.

Не удалось выполнить запрос из-за ключевой проблемы, например проблемы с подключением к сети, ошибки DNS или ошибки проверки сертификата сервера (или времени ожидания только для .NET Framework).

Только .NET Core и .NET 5 и более поздних версий. Запрос завершился сбоем из-за истечения времени ожидания.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего текста ответа.

Примечание

В случае истечения времени ожидания:

  • платформа .NET Framework вызывает исключение HttpRequestException.
  • .NET Core создает исключение без каких-либо внутренних исключений TaskCanceledException .
  • В .NET 5 и более поздних версиях создается TaskCanceledException объект , который вложен в TimeoutException.

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