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

HttpClient.GetStringAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Http
Сборка:
System.Net.Http.dll
Сборка:
netstandard.dll

Отправка запроса 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), по которому отправляется запрос.

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

Task<String>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

Предоставленный 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), по которому отправляется запрос.

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

Task<String>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

Только .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

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

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

Task<String>

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

Исключения

ArgumentNullException

Значение параметра requestUri — null.

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

Комментарии

Эта операция не блокируется. Возвращенный 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

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

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

Task<String>

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

Исключения

ArgumentNullException

Значение параметра requestUri — null.

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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

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