HttpClient.GetAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции.
Перегрузки
| Имя | Описание |
|---|---|
| GetAsync(String) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| GetAsync(Uri) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции. |
| GetAsync(String, HttpCompletionOption) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции. |
| GetAsync(String, CancellationToken) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции. |
| GetAsync(Uri, HttpCompletionOption) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции. |
| GetAsync(Uri, CancellationToken) |
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции. |
Комментарии
Операция не блокируется.
GetAsync(String)
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое). Это же поведение, как если бы ResponseContentRead оно было явно указано.
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(Uri)
Отправьте запрос GET в указанный универсальный код ресурса (URI) в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое). Это же поведение, как если бы ResponseContentRead оно было явно указано.
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(String, HttpCompletionOption)
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
- completionOption
- HttpCompletionOption
Значение параметра завершения HTTP, указывающее, когда операция должна рассматриваться как завершенная.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за базовой проблемы, такой как сетевое подключение, сбой DNS, проверка сертификата сервера или время ожидания.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится на completionOption основе параметра после чтения части или всего ответа (включая содержимое).
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(String, CancellationToken)
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое). Это же поведение, как если бы ResponseContentRead оно было явно указано.
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(Uri, HttpCompletionOption)
Отправьте запрос GET в указанный URI с параметром завершения HTTP в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
- completionOption
- HttpCompletionOption
Значение параметра завершения HTTP, указывающее, когда операция должна рассматриваться как завершенная.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится на completionOption основе параметра после чтения части или всего ответа (включая содержимое).
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(Uri, CancellationToken)
Отправьте запрос GET в указанный универсальный код ресурса (URI) с маркером отмены в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы, связанной с получением HTTP-ответа, например подключения к сети, сбоя DNS или проверки сертификата сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое). Это же поведение, как если бы ResponseContentRead оно было явно указано.
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(String, HttpCompletionOption, CancellationToken)
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
- completionOption
- HttpCompletionOption
Значение параметра завершения HTTP, указывающее, когда операция должна рассматриваться как завершенная.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится на completionOption основе параметра после чтения части или всего ответа (включая содержимое).
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
GetAsync(Uri, HttpCompletionOption, CancellationToken)
Отправьте запрос GET в указанный URI с параметром завершения HTTP и маркером отмены в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
- completionOption
- HttpCompletionOption
Значение параметра завершения HTTP, указывающее, когда операция должна рассматриваться как завершенная.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится на completionOption основе параметра после чтения части или всего ответа (включая содержимое).
Замечание
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.