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


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<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);
member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())

Параметры

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<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);
member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())

Параметры

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<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())

Параметры

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<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())

Параметры

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.

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