HttpContent.ReadAsStreamAsync Método

Definición

Espacio de nombres:

System.Net.Http

Ensamblados:

netstandard.dll, System.Net.Http.dll

Serializa el contenido HTTP y devuelve una secuencia que representa el contenido.

Sobrecargas

Nombre	Description
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 CreateContentReadStreamAsync() que se haya implementado para hacerlo de 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 se completará una vez que se haya leído Task<TResult> todo el flujo que representa el contenido.

Una vez completada la operación, la Result propiedad 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 devuelto se completará después de que se haya leído Task<TResult> todo el flujo que representa el contenido (a menos CreateContentReadStream(CancellationToken) que se haya implementado para hacer lo contrario). Por ejemplo, cuando se usa HttpClient, un método como SendAsync devuelve una clase derivada de HttpContent esos búferes condicionales en función de lo que se pasa para el completionOption parámetro .

Una vez completada la operación, la Result propiedad 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().