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


HttpClient.GetAsync Метод

Определение

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

Перегрузки

GetAsync(String)

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

GetAsync(Uri)

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

GetAsync(String, HttpCompletionOption)

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

GetAsync(String, CancellationToken)

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

GetAsync(Uri, HttpCompletionOption)

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

GetAsync(Uri, CancellationToken)

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

GetAsync(String, HttpCompletionOption, CancellationToken)

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

GetAsync(Uri, HttpCompletionOption, CancellationToken)

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

Комментарии

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

GetAsync(String)

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

Отправка запроса 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);
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.

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

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

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое). Поведение будет таким же, как если ResponseContentRead бы оно было явно указано.

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(Uri)

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

Отправка запроса 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);
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.

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

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое). Поведение будет таким же, как если ResponseContentRead бы оно было явно указано.

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(String, HttpCompletionOption)

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

Отправка запроса 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);
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.
  • TaskCanceledException во всех применимых версиях .NET Core возникает исключение без каких-либо внутренних исключений.
  • TaskCanceledException объект , вложенный в TimeoutException , создается в .NET 5 и более поздних версиях.

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

GetAsync(String, CancellationToken)

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

Отправка запроса DELETE указанному универсальному коду ресурса (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);
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.

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

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

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

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое). Поведение будет таким же, как если ResponseContentRead бы оно было явно указано.

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(Uri, HttpCompletionOption)

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

Отправка запроса 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);
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.

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

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

Комментарии

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

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(Uri, CancellationToken)

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

Отправка запроса DELETE указанному универсальному коду ресурса (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);
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.

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

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

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

Комментарии

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое). Поведение будет таким же, как если ResponseContentRead бы оно было явно указано.

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(String, HttpCompletionOption, CancellationToken)

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

Отправка запроса 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);
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.

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

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

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

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

Комментарии

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

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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

GetAsync(Uri, HttpCompletionOption, CancellationToken)

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

Отправка запроса 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);
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.

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

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

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

Комментарии

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

Примечание

В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.

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

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