Partilhar via


HttpRequest.GetBufferlessInputStream Método

Definição

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

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:

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

Aplica-se a

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

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:

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

Aplica-se a