HttpClient.GetAsync Метод

Определение

Пространство имен:

System.Net.Http

Сборка:

System.Net.Http.dll

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

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

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

Комментарии

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

Примечание

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

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

GetAsync(Uri)

Исходный код:

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);

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

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

Комментарии

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

Примечание

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

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

GetAsync(String, HttpCompletionOption)

Исходный код:

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);

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, указывающее, когда следует считать операцию завершенной.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

Комментарии

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

Примечание

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

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

GetAsync(String, CancellationToken)

Исходный код:

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);

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

Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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

GetAsync(Uri, HttpCompletionOption)

Исходный код:

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);

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, указывающее, когда следует считать операцию завершенной.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

Комментарии

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

Примечание

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

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

GetAsync(Uri, CancellationToken)

Исходный код:

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);

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

Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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

GetAsync(String, HttpCompletionOption, CancellationToken)

Исходный код:

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);

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

Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Исходный код:

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);

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

Токен отмены, который может использоваться другими объектами или потоками для получения уведомления об отмене.

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

Task<HttpResponseMessage>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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