Ағылшын тілінде оқу

Бөлісу құралы:


HttpClient.GetByteArrayAsync Метод

Определение

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

Перегрузки

GetByteArrayAsync(String)

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

GetByteArrayAsync(Uri)

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

GetByteArrayAsync(String, CancellationToken)

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

GetByteArrayAsync(Uri, CancellationToken)

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

Комментарии

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

GetByteArrayAsync(String)

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

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

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);

Параметры

requestUri
String

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

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

Task<Byte[]>

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

Исключения

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

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

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

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

Комментарии

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

Ескерім

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

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

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

GetByteArrayAsync(Uri)

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

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

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);

Параметры

requestUri
Uri

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

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

Task<Byte[]>

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

Исключения

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

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

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

Комментарии

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

Ескерім

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

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

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

GetByteArrayAsync(String, CancellationToken)

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

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

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

Параметры

requestUri
String

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

cancellationToken
CancellationToken

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

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

Task<Byte[]>

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

Исключения

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

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

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

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

Комментарии

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

Ескерім

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

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

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

GetByteArrayAsync(Uri, CancellationToken)

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

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

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

Параметры

requestUri
Uri

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

cancellationToken
CancellationToken

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

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

Task<Byte[]>

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

Исключения

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

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

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

Комментарии

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

Ескерім

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

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

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