HttpRequest.GetBufferlessInputStream Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Obtém um objeto Stream que pode ser usado para ler o corpo da entidade HTTP de entrada.

Sobrecargas

GetBufferlessInputStream()	Obtém um objeto Stream que pode ser usado para ler o corpo da entidade HTTP de entrada.
GetBufferlessInputStream(Boolean)	Obtém um objeto Stream que pode ser usado para ler o corpo da entidade HTTP recebida, opcionalmente desabilitando o limite de tamanho de solicitação definido na propriedade MaxRequestLength.

GetBufferlessInputStream()

Obtém um objeto Stream que pode ser usado para ler o corpo da entidade HTTP de entrada.

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

HttpException

O corpo da entidade da solicitação já foi carregado e analisado. Veja alguns exemplos de propriedades que fazem o corpo da entidade ser carregado e analisado:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Para evitar essa exceção, chame o método ReadEntityBodyMode primeiro. Essa exceção também será gerada se o cliente se desconectar enquanto o corpo da entidade é lido.

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()

GetBufferlessInputStream(Boolean)

Obtém um objeto Stream que pode ser usado para ler o corpo da entidade HTTP recebida, opcionalmente desabilitando o limite de tamanho de solicitação definido na propriedade MaxRequestLength.

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

disableMaxRequestLength

Boolean

true para desabilitar o limite de tamanho de solicitação, caso contrário, false.

Retornos

Stream

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

Exceções

HttpException

O corpo da entidade da solicitação já foi carregado e analisado. Veja alguns exemplos de propriedades que fazem o corpo da entidade ser carregado e analisado:

• A propriedade Form.

• A propriedade Files.

• A propriedade InputStream.

• O método GetBufferedInputStream().

Para evitar essa exceção, chame o método ReadEntityBodyMode primeiro. Essa exceção também será gerada se o cliente se desconectar enquanto o corpo da entidade é lido.

Comentários

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

Confira também

• GetBufferedInputStream()