HttpRequest.GetBufferlessInputStream Método

public:
 System::IO::Stream ^ GetBufferlessInputStream();

public System.IO.Stream GetBufferlessInputStream();

member this.GetBufferlessInputStream : unit -> System.IO.Stream

Public Function GetBufferlessInputStream () As Stream

Devoluções

Um Stream objeto que pode ser usado para ler o corpo da entidade HTTP recebida.

Exceções

Observações

Este método oferece uma alternativa à utilização da InputStream propriedade. A InputStream propriedade espera que o pedido completo seja recebido antes de devolver um Stream objeto. Em contraste, o GetBufferlessInputStream método devolve o Stream objeto imediatamente. Pode usar o método para começar a processar o corpo da entidade antes de o conteúdo completo do corpo ter sido recebido.

O corpo da entidade (ou tanto quanto solicitar e ter sido recebido) só é devolvido quando utiliza o objeto devolvido por este método para ler o fluxo, chamando métodos como o Read método. Usas parâmetros do Read método para especificar quanto do corpo da entidade deves ler.

O objeto Stream devolvido por ASP.NET deste método suporta tanto métodos de leitura síncronos como assíncronos. O Stream objeto implementa ambos os BeginRead métodos e EndRead . Os métodos assíncronos permitem ler assíncronamente a entidade do pedido em blocos, enquanto o ASP.NET liberta o thread atual entre cada iteração de um ciclo de leitura assíncrono.

Este método pode ser útil se o pedido estiver a carregar um ficheiro grande e quiser começar a aceder ao conteúdo do ficheiro antes de o upload terminar. No entanto, deve usar este método apenas para cenários em que pretende assumir todo o processamento do corpo da entidade. Isto significa que não pode usar este método a partir de uma página .aspx, porque quando uma página .aspx é executada, o corpo da entidade já foi lido.

Ver também

• GetBufferedInputStream()

public:
 System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);

public System.IO.Stream GetBufferlessInputStream(bool disableMaxRequestLength);

member this.GetBufferlessInputStream : bool -> System.IO.Stream

Public Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As Stream

Parâmetros

Devoluções

Um Stream objeto que pode ser usado para ler o corpo da entidade HTTP recebida.

Exceções

Observações

Para mais informações sobre este método, veja a GetBufferlessInputStream() sobrecarga.

Ver também

• GetBufferedInputStream()