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

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

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