HttpContent.CreateContentReadStreamAsync Método

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Sobrecargas

CreateContentReadStreamAsync()	Serializa o conteúdo HTTP em um fluxo de memória como uma operação assíncrona.
CreateContentReadStreamAsync(CancellationToken)	Serializa o conteúdo HTTP em um fluxo de memória como uma operação assíncrona.

CreateContentReadStreamAsync()

Origem:

HttpContent.cs

Serializa o conteúdo HTTP em um fluxo de memória como uma operação assíncrona.

protected:
 virtual System::Threading::Tasks::Task<System::IO::Stream ^> ^ CreateContentReadStreamAsync();

protected virtual System.Threading.Tasks.Task<System.IO.Stream> CreateContentReadStreamAsync ();

abstract member CreateContentReadStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>
override this.CreateContentReadStreamAsync : unit -> System.Threading.Tasks.Task<System.IO.Stream>

Protected Overridable Function CreateContentReadStreamAsync () 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 retornado Task<TResult> será concluído depois que todo o conteúdo tiver sido gravado no fluxo de memória.

Depois que a operação for concluída, a Result propriedade no objeto de tarefa retornado conterá o fluxo de memória que representa o conteúdo HTTP. Em seguida, o fluxo retornado pode ser usado para ler o conteúdo usando várias APIs de fluxo.

O CreateContentReadStreamAsync método armazena o conteúdo em buffer em um fluxo de memória. Classes derivadas podem substituir esse comportamento se houver uma maneira melhor de recuperar o conteúdo como fluxo. Por exemplo, uma matriz de bytes ou uma cadeia de caracteres poderia usar um método mais eficiente, como encapsular um somente MemoryStream leitura em torno dos bytes ou da cadeia de caracteres.

CreateContentReadStreamAsync(CancellationToken)

Origem:

HttpContent.cs

Serializa o conteúdo HTTP em um fluxo de memória como uma operação assíncrona.

protected:
 virtual System::Threading::Tasks::Task<System::IO::Stream ^> ^ CreateContentReadStreamAsync(System::Threading::CancellationToken cancellationToken);

protected virtual System.Threading.Tasks.Task<System.IO.Stream> CreateContentReadStreamAsync (System.Threading.CancellationToken cancellationToken);

abstract member CreateContentReadStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>
override this.CreateContentReadStreamAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Stream>

Protected Overridable Function CreateContentReadStreamAsync (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 retornado Task<TResult> será concluído depois que todo o conteúdo tiver sido gravado no fluxo de memória.

Depois que a operação for concluída, a Result propriedade no objeto de tarefa retornado conterá o fluxo de memória que representa o conteúdo HTTP. Em seguida, o fluxo retornado pode ser usado para ler o conteúdo usando várias APIs de fluxo.

O CreateContentReadStreamAsync método armazena o conteúdo em buffer em um fluxo de memória. Classes derivadas podem substituir esse comportamento se houver uma maneira melhor de recuperar o conteúdo como fluxo. Por exemplo, uma matriz de bytes ou uma cadeia de caracteres poderia usar um método mais eficiente, como encapsular um somente MemoryStream leitura em torno dos bytes ou da cadeia de caracteres.)