HttpRequest.GetBufferlessInputStream Método

Definición

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.

Sobrecargas

GetBufferlessInputStream()

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.

GetBufferlessInputStream(Boolean)

Obtiene un objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP entrante y deshabilita opcionalmente el límite de longitud de la solicitud que se establece en la propiedad MaxRequestLength.

GetBufferlessInputStream()

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.

public:
 System::IO::Stream ^ GetBufferlessInputStream();
public System.IO.Stream GetBufferlessInputStream ();
member this.GetBufferlessInputStream : unit -> System.IO.Stream
Public Function GetBufferlessInputStream () As Stream

Devoluciones

Objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP de entrada.

Excepciones

El cuerpo de la entidad de la solicitud ya se ha cargado y ha analizado. Entre los ejemplos de propiedades que producen la carga y el análisis del cuerpo de la entidad se incluyen los siguientes:

Para evitar esta excepción, llame primero al método ReadEntityBodyMode. Esta excepción también se produce si el cliente se desconecta mientras se está leyendo el cuerpo de la entidad.

Comentarios

Este método proporciona una alternativa al uso de la InputStream propiedad . La InputStream propiedad espera hasta que se haya recibido toda la solicitud antes de que devuelva un Stream objeto . En cambio, el GetBufferlessInputStream método devuelve el Stream objeto inmediatamente. Puede usar el método para comenzar a procesar el cuerpo de la entidad antes de que se haya recibido el contenido completo del cuerpo.

El cuerpo de la entidad (o tanto como solicite y se ha recibido) solo se devuelve cuando se usa el objeto devuelto por este método para leer la secuencia, llamando a métodos como el Read método . Los parámetros del Read método se usan para especificar la cantidad del cuerpo de la entidad que se va a leer.

El Stream objeto devuelto por ASP.NET de este método admite métodos de lectura sincrónicos y asincrónicos. El Stream objeto implementa los BeginRead métodos y EndRead . Los métodos asincrónicos permiten leer de forma asincrónica la entidad de solicitud en fragmentos, mientras que ASP.NET libera el subproceso actual entre cada iteración de un bucle de lectura asincrónico.

Este método puede ser útil si la solicitud carga un archivo grande y desea empezar a acceder al contenido del archivo antes de que finalice la carga. Sin embargo, solo debe usar este método para escenarios en los que desea asumir todo el procesamiento del cuerpo de la entidad. Esto significa que no puede usar este método desde una página .aspx, ya que en el momento en que se ejecuta una página .aspx, el cuerpo de la entidad ya se ha leído.

Consulte también

Se aplica a

GetBufferlessInputStream(Boolean)

Obtiene un objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP entrante y deshabilita opcionalmente el límite de longitud de la solicitud que se establece en la propiedad 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 deshabilitar el límite de longitud de la solicitud; en caso contrario, false.

Devoluciones

Objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP de entrada.

Excepciones

El cuerpo de la entidad de la solicitud ya se ha cargado y ha analizado. Entre los ejemplos de propiedades que producen la carga y el análisis del cuerpo de la entidad se incluyen los siguientes:

Para evitar esta excepción, llame primero al método ReadEntityBodyMode. Esta excepción también se produce si el cliente se desconecta mientras se está leyendo el cuerpo de la entidad.

Comentarios

Para obtener más información sobre este método, consulte la GetBufferlessInputStream() sobrecarga.

Consulte también

Se aplica a