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

Retornos

Stream

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

Exceções

Comentários

Esse método fornece uma alternativa ao uso da InputStream propriedade. A InputStream propriedade aguarda até que toda a solicitação seja recebida antes de retornar um Stream objeto. Em contraste, o GetBufferlessInputStream método retorna o Stream objeto imediatamente. Você pode usar o método para começar a processar o corpo da entidade antes que o conteúdo completo do corpo tenha sido recebido.

O corpo da entidade (ou tanto quanto você solicita e foi recebido) é retornado somente quando você usa o objeto retornado por esse método para ler o fluxo, chamando métodos como o Read método. Você usa parâmetros do Read método para especificar quanto do corpo da entidade deve ser lido.

O Stream objeto retornado por ASP.NET desse método dá suporte a métodos de leitura síncronos e assíncronos. O Stream objeto implementa os métodos e EndRead os BeginRead métodos. Os métodos assíncronos permitem que você leia assíncronamente a entidade de solicitação em partes, enquanto ASP.NET libera o thread atual entre cada iteração de um loop de leitura assíncrono.

Esse método pode ser útil se a solicitação estiver carregando um arquivo grande e você quiser começar a acessar o conteúdo do arquivo antes que o carregamento seja concluído. No entanto, você só deve usar esse método para cenários em que deseja assumir todo o processamento do corpo da entidade. Isso significa que você não pode usar esse método de uma página .aspx, porque quando uma página .aspx é executada, o corpo da entidade já foi lido.

Confira 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

Retornos

Stream

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

Exceções

Comentários

Para obter mais informações sobre esse método, consulte a GetBufferlessInputStream() sobrecarga.

Confira também

• GetBufferedInputStream()