HttpRequest.GetBufferlessInputStream Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.StreamPublic Function GetBufferlessInputStream () As StreamDevoluciones
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.StreamPublic Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As StreamPará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:
Propiedad Form
Propiedad Files
Propiedad InputStream
El método GetBufferedInputStream() .
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.
