HttpContent.ReadAsStreamAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Serializa el contenido HTTP y devuelve una secuencia que representa el contenido.
Sobrecargas
| ReadAsStreamAsync() |
Serialice el contenido HTTP y devuelva una secuencia que represente el contenido como una operación asincrónica. |
| ReadAsStreamAsync(CancellationToken) |
Serialice el contenido HTTP y devuelva una secuencia que represente el contenido como una operación asincrónica. |
Comentarios
Tenga en cuenta que este método almacenará internamente en búfer el contenido a menos que CreateContentReadStreamAsync() se haya implementado para lo contrario.
ReadAsStreamAsync()
- Source:
- HttpContent.cs
- Source:
- HttpContent.cs
- Source:
- HttpContent.cs
Serialice el contenido HTTP y devuelva una secuencia que represente el contenido como una operación asincrónica.
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)Devoluciones
Objeto de tarea que representa la operación asincrónica.
Comentarios
Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará una vez que se haya leído todo el flujo que representa el contenido.
Una vez completada la operación, la propiedad Result del objeto de tarea devuelto contiene la secuencia que representa el contenido HTTP. Después, la secuencia devuelta se puede usar para leer el contenido mediante varias API de secuencia.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ReadAsStream().
Se aplica a
ReadAsStreamAsync(CancellationToken)
- Source:
- HttpContent.cs
- Source:
- HttpContent.cs
- Source:
- HttpContent.cs
Serialice el contenido HTTP y devuelva una secuencia que represente el contenido como una operación asincrónica.
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)Parámetros
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Esta operación no se bloqueará. El objeto Task<TResult> devuelto se completará después de que se haya leído toda la secuencia que representa el contenido (a menos que se haya implementado CreateContentReadStream(CancellationToken) para lo contrario).
Por ejemplo, cuando se usa HttpClient, un método como SendAsync devuelve una clase derivada de HttpContent que almacena búferes condicionalmente en función de lo que se pasa para el parámetro completionOption.
Una vez completada la operación, la propiedad Result del objeto de tarea devuelto contiene la secuencia que representa el contenido HTTP. Después, la secuencia devuelta se puede usar para leer el contenido mediante varias API de secuencia.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ReadAsStream().
