HttpContent.ReadAsStreamAsync Метод

Определение

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

System.Net.Http

Сборка:

System.Net.Http.dll

Сериализует HTTP-содержимое и возвращает поток, представляющий содержимое.

Перегрузки

ReadAsStreamAsync()	Сериализует HTTP-содержимое и возвращает поток, представляющий содержимое в асинхронной операции.
ReadAsStreamAsync(CancellationToken)	Сериализует HTTP-содержимое и возвращает поток, представляющий содержимое в асинхронной операции.

Комментарии

Обратите внимание, что этот метод будет внутренне буферизовать содержимое, если CreateContentReadStreamAsync() не реализовано иное.

ReadAsStreamAsync()

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

HttpContent.cs

Сериализует HTTP-содержимое и возвращает поток, представляющий содержимое в асинхронной операции.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync();

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync ();

member this.ReadAsStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function ReadAsStreamAsync () As Task(Of Stream)

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

Task<Stream>

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

Комментарии

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

После завершения операции свойство возвращаемого объекта задачи содержит поток, Result представляющий содержимое HTTP. Затем возвращаемый поток можно использовать для чтения содержимого с помощью различных API потока.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ReadAsStream().

ReadAsStreamAsync(CancellationToken)

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

HttpContent.cs

Сериализует HTTP-содержимое и возвращает поток, представляющий содержимое в асинхронной операции.

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ ReadAsStreamAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.IO.Stream> ReadAsStreamAsync (System.Threading.CancellationToken cancellationToken);

member this.ReadAsStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function ReadAsStreamAsync (cancellationToken As CancellationToken) As Task(Of Stream)

Параметры

cancellationToken

CancellationToken

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

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

Task<Stream>

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

Исключения

OperationCanceledException

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

Комментарии

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

После завершения операции свойство возвращаемого объекта задачи содержит поток, Result представляющий содержимое HTTP. Затем возвращаемый поток можно использовать для чтения содержимого с помощью различных API потока.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ReadAsStream().