HttpContent.ReadAsStreamAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сериализует содержимое HTTP и возвращает поток, представляющий содержимое.
Перегрузки
| ReadAsStreamAsync() |
Сериализируйте содержимое HTTP и верните поток, представляющий содержимое как асинхронную операцию. |
| ReadAsStreamAsync(CancellationToken) |
Сериализируйте содержимое HTTP и верните поток, представляющий содержимое как асинхронную операцию. |
Комментарии
Обратите внимание, что этот метод будет внутренне буферизовать содержимое, если CreateContentReadStreamAsync() не реализовано для выполнения других действий.
ReadAsStreamAsync()
- Исходный код:
- HttpContent.cs
- Исходный код:
- HttpContent.cs
- Исходный код:
- 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<TResult> завершится после чтения всего потока, представляющего содержимое.
После завершения операции свойство Result возвращаемого объекта задачи содержит поток, представляющий содержимое HTTP. Затем возвращаемый поток можно использовать для чтения содержимого с помощью различных API потоков.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ReadAsStream().
Применяется к
ReadAsStreamAsync(CancellationToken)
- Исходный код:
- HttpContent.cs
- Исходный код:
- HttpContent.cs
- Исходный код:
- 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<TResult> завершится после того, как весь поток, представляющий содержимое, считывается (если CreateContentReadStream(CancellationToken) не реализовано для выполнения других действий).
Например, при использовании HttpClientметод, например SendAsync, возвращает класс, производный от HttpContent, который условно буферизируется на основе того, что передается для параметра completionOption.
После завершения операции свойство Result возвращаемого объекта задачи содержит поток, представляющий содержимое HTTP. Затем возвращаемый поток можно использовать для чтения содержимого с помощью различных API потоков.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых ReadAsStream().
