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

HttpClient.GetStreamAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net.Http
Сборка:
System.Net.Http.dll
Сборка:
netstandard.dll

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

Перегрузки

GetStreamAsync(Uri, CancellationToken)

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

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

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

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

Комментарии

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

GetStreamAsync(Uri, CancellationToken)

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

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStreamAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function GetStreamAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Stream)

Параметры

requestUri
Uri

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

cancellationToken
CancellationToken

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

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

Task<Stream>

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

Исключения

ArgumentNullException

Значение параметра requestUri — null.

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

Комментарии

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

Примечание

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

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

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

GetStreamAsync(String, CancellationToken)

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

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStreamAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function GetStreamAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Stream)

Параметры

requestUri
String

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

cancellationToken
CancellationToken

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

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

Task<Stream>

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

Исключения

OperationCanceledException

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

Комментарии

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

Примечание

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

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

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

GetStreamAsync(Uri)

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

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri requestUri);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (Uri? requestUri);
member this.GetStreamAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function GetStreamAsync (requestUri As Uri) As Task(Of Stream)

Параметры

requestUri
Uri

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

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

Task<Stream>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

Комментарии

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

Примечание

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

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

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

GetStreamAsync(String)

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

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ GetStreamAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string requestUri);
public System.Threading.Tasks.Task<System.IO.Stream> GetStreamAsync (string? requestUri);
member this.GetStreamAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function GetStreamAsync (requestUri As String) As Task(Of Stream)

Параметры

requestUri
String

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

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

Task<Stream>

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

Исключения

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

Комментарии

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

Примечание

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

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

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