HttpContent.CreateContentReadStream(CancellationToken) Método

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

HttpContent.cs

Serializa o conteúdo HTTP para um fluxo de memória.

protected:
 virtual System::IO::Stream ^ CreateContentReadStream(System::Threading::CancellationToken cancellationToken);

protected virtual System.IO.Stream CreateContentReadStream (System.Threading.CancellationToken cancellationToken);

abstract member CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream
override this.CreateContentReadStream : System.Threading.CancellationToken -> System.IO.Stream

Protected Overridable Function CreateContentReadStream (cancellationToken As CancellationToken) As Stream

Parâmetros

cancellationToken

CancellationToken

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

Retornos

Stream

O fluxo de memória de saída que contém o conteúdo HTTP serializado.

Exceções

OperationCanceledException

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

Comentários

Depois que a operação for concluída, o fluxo de memória retornado representará o conteúdo HTTP. O fluxo retornado pode ser usado para ler o conteúdo usando várias APIs de fluxo. O CreateContentReadStream(CancellationToken) método armazena o conteúdo em buffer em um fluxo de memória. Classes derivadas poderão 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 uma maneira de método mais eficiente, como encapsular um MemoryStream somente leitura ao redor dos bytes ou da cadeia de caracteres.