HttpContent.ReadAsStreamAsync Método

Definición

Espacio de nombres:

System.Net.Http

Ensamblado:

System.Net.Http.dll

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

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

Task<Stream>

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().

ReadAsStreamAsync(CancellationToken)

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

Task<Stream>

Objeto de tarea que representa la operación asincrónica.

Excepciones

OperationCanceledException

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().