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

HttpClient.GetAsync Метод

  • Ссылка

Определение

Пространство имен:
Windows.Web.Http

Перегрузки

GetAsync(Uri)

Отправка запроса GET согласно указанному универсальному коду ресурса (URI) в качестве асинхронной операции. Руководство по программированию для класса HttpClient и примеры кода см. в разделе о концепции HttpClient .
GetAsync(Uri, HttpCompletionOption)

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

GetAsync(Uri)

Изменить

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

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Параметры

uri
Uri Uri

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

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

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

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

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Комментарии

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

Пример кода в C#/VB/C++ и XAML, демонстрирующий использование HttpClient и GetAsync(Uri) для подключения к HTTP-серверу и отправки запроса GET, см. в разделе HttpClient.

Пример кода в JavaScript и HTML, демонстрирующий использование HttpClient и GetAsync(Uri) для подключения к HTTP-серверу и отправки запроса GET, см. в статье Подключение к HTTP-серверу с помощью Windows.Web.Http.

Ниже приведены исключения, создаваемые этой функцией.

COMException

Возникает, когда функция HRESULT возвращается из вызова метода.

Это наиболее распространенное исключение, вызываемое сетевыми методами. Приложение должно использовать HRESULT из исключения, чтобы определить причину ошибки.

AccessDeniedException

Возникает при запрете доступа к ресурсу или функции. Это исключение возникает, когда приложение не имеет необходимых сетевых возможностей, заданных в манифесте приложения для запрошенной сетевой операции.

InvalidArgumentException

Вызывается, если один из передаваемых методу аргументов является недопустимым.

Если предоставленные пользователем входные данные вызвали это исключение, приложение может сообщить пользователю и запросить новые входные данные.

ObjectDisposedException

Вызывается при выполнении операции над ликвидированным объектом.

OutOfMemoryException

Возникает, если для завершения операции недостаточно памяти.

См. также раздел

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

GetAsync(Uri, HttpCompletionOption)

Изменить

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

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Параметры

uri
Uri Uri

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

completionOption
HttpCompletionOption

Значение параметра завершения операции HTTP, указывающее, когда следует считать операцию завершенной.

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

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

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

Атрибуты
OverloadAttribute RemoteAsyncAttribute

Комментарии

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

Ниже приведены исключения, которые создает это содержимое.

COMException

Возникает, когда функция HRESULT возвращается из вызова метода.

Это наиболее распространенное исключение, вызываемое сетевыми методами. Приложение должно использовать HRESULT из исключения, чтобы определить причину ошибки.

AccessDeniedException

Возникает при запрете доступа к ресурсу или функции. Это исключение возникает, когда приложение не имеет необходимых сетевых возможностей, заданных в манифесте приложения для запрошенной сетевой операции.

InvalidArgumentException

Вызывается, если один из передаваемых методу аргументов является недопустимым.

Если предоставленные пользователем входные данные вызвали это исключение, приложение может сообщить пользователю и запросить новые входные данные.

ObjectDisposedException

Вызывается при выполнении операции над ликвидированным объектом.

OutOfMemoryException

Возникает, если для завершения операции недостаточно памяти.

См. также раздел

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