HttpContent.ReadAsStreamAsync Метод

Определение

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

System.Net.Http

Сборки:

netstandard.dll, 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> объект завершится после того, как весь поток, представляющий содержимое, был считывается (если CreateContentReadStream(CancellationToken) не было реализовано в противном случае). Например, при использовании HttpClientметода, например SendAsync , возвращается класс, производный от HttpContent этого условно буфера, на основе того, что передается для completionOption параметра.

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

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