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> объект завершится после считывания всего потока, представляющего содержимое.
После завершения операции свойство возвращаемого объекта задачи содержит поток, Result представляющий содержимое HTTP. Затем возвращаемый поток можно использовать для чтения содержимого с помощью различных API потока.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ReadAsStream().
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по