HttpContent.ReadAsStreamAsync Método

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Serializa o conteúdo HTTP e retorna um fluxo que representa o conteúdo.

Sobrecargas

ReadAsStreamAsync()	Serialize o conteúdo HTTP e retorne um fluxo que representa o conteúdo como uma operação assíncrona.
ReadAsStreamAsync(CancellationToken)	Serialize o conteúdo HTTP e retorne um fluxo que representa o conteúdo como uma operação assíncrona.

Comentários

Observe que esse método armazenará o conteúdo em buffer internamente, a menos que CreateContentReadStreamAsync() tenha sido implementado para fazer o contrário.

ReadAsStreamAsync()

Origem:

HttpContent.cs

Serialize o conteúdo HTTP e retorne um fluxo que representa o conteúdo como uma operação assíncrona.

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)

Retornos

Task<Stream>

O objeto de tarefa que representa a operação assíncrona.

Comentários

Essa operação não será bloqueada. O objeto Task<TResult> retornado será concluído depois que todo o fluxo que representa o conteúdo tiver sido lido.

Após a conclusão da operação, a propriedade Result no objeto de tarefa retornado contém o fluxo que representa o conteúdo HTTP. O fluxo retornado pode ser usado para ler o conteúdo usando várias APIs de fluxo.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ReadAsStream().

ReadAsStreamAsync(CancellationToken)

Origem:

HttpContent.cs

Serialize o conteúdo HTTP e retorne um fluxo que representa o conteúdo como uma operação assíncrona.

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

O token de cancelamento para cancelar a operação.

Retornos

Task<Stream>

O objeto de tarefa que representa a operação assíncrona.

Exceções

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa operação não será bloqueada. O objeto Task<TResult> retornado será concluído depois que todo o fluxo que representa o conteúdo tiver sido lido (a menos que CreateContentReadStream(CancellationToken) tenha sido implementado para fazer o contrário). Por exemplo, ao usar HttpClient, um método como SendAsync retorna uma classe derivada de HttpContent que armazena buffers condicionalmente com base no que é passado para o parâmetro completionOption.

Após a conclusão da operação, a propriedade Result no objeto de tarefa retornado contém o fluxo que representa o conteúdo HTTP. O fluxo retornado pode ser usado para ler o conteúdo usando várias APIs de fluxo.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ReadAsStream().