HttpRequest.GetBufferlessInputStream Método

Definición

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.Gets a Stream object that can be used to read the incoming HTTP entity body.

Sobrecargas

GetBufferlessInputStream()

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.Gets a Stream object that can be used to read the incoming HTTP entity body.

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.Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

GetBufferlessInputStream()

Obtiene un objeto Stream que se puede usar para leer el cuerpo de entidad HTTP entrante.Gets a Stream object that can be used to read the incoming HTTP entity body.

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

Devoluciones

Stream

Objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP de entrada.A Stream object that can be used to read the incoming HTTP entity body.

Excepciones

El cuerpo de la entidad de la solicitud ya se ha cargado y ha analizado.The request's entity body has already been loaded and parsed. Entre los ejemplos de propiedades que producen la carga y el análisis del cuerpo de la entidad se incluyen los siguientes:Examples of properties that cause the entity body to be loaded and parsed include the following:

Para evitar esta excepción, llame primero al método ReadEntityBodyMode.To avoid this exception, call the ReadEntityBodyMode method first. Esta excepción también se produce si el cliente se desconecta mientras se está leyendo el cuerpo de la entidad.This exception is also thrown if the client disconnects while the entity body is being read.

Comentarios

Este método proporciona una alternativa al uso de la InputStream propiedad.This method provides an alternative to using the InputStream property. La InputStream propiedad espera hasta que se haya recibido toda la solicitud antes de devolver un Stream objeto.The InputStream property waits until the whole request has been received before it returns a Stream object. Por el contrario, el GetBufferlessInputStream método devuelve el Stream objeto inmediatamente.In contrast, the GetBufferlessInputStream method returns the Stream object immediately. Puede usar el método para empezar a procesar el cuerpo de la entidad antes de que se haya recibido el contenido completo del cuerpo.You can use the method to begin processing the entity body before the complete contents of the body have been received.

El cuerpo de la entidad (o tanto como se solicita y se ha recibido) solo se devuelve cuando se usa el objeto devuelto por este método para leer el flujo, llamando a métodos como el Read método.The entity body (or as much of it as you request and has been received) is returned only when you use the object that is returned by this method to read the stream, by calling methods such as the Read method. Use los parámetros del Read método para especificar la cantidad del cuerpo de la entidad que se va a leer.You use parameters of the Read method to specify how much of the entity body to read.

El Stream objeto devuelto por ASP.net desde este método admite métodos Read sincrónicos y asincrónicos.The Stream object returned by ASP.NET from this method supports both synchronous and asynchronous read methods. El Stream objeto implementa los BeginRead EndRead métodos y.The Stream object implements both the BeginRead and EndRead methods. 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.The asynchronous methods let you asynchronously read the request entity in chunks, while ASP.NET releases the current thread in between each iteration of an asynchronous read loop.

Este método puede ser útil si la solicitud está cargando un archivo grande y desea comenzar a acceder al contenido del archivo antes de que finalice la carga.This method can be useful if the request is uploading a large file and you want to begin accessing the file contents before the upload is finished. Sin embargo, solo debe usar este método para los escenarios en los que desea asumir todo el procesamiento del cuerpo de la entidad.However, you should only use this method for scenarios where you want to take over all processing of the entity body. Esto significa que no puede usar este método desde una página. aspx, porque, cuando se ejecuta una página. aspx, el cuerpo de la entidad ya se ha leído.This means that you cannot use this method from an .aspx page, because by the time an .aspx page runs, the entity body has already been read.

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.Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

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.true to disable the request-length limit; otherwise, false.

Devoluciones

Stream

Objeto Stream que se puede usar para leer el cuerpo de la entidad HTTP de entrada.A Stream object that can be used to read the incoming HTTP entity body.

Excepciones

El cuerpo de la entidad de la solicitud ya se ha cargado y ha analizado.The request's entity body has already been loaded and parsed. Entre los ejemplos de propiedades que producen la carga y el análisis del cuerpo de la entidad se incluyen los siguientes:Examples of properties that cause the entity body to be loaded and parsed include the following:

- La propiedad Form.- The Form property.

- La propiedad Files.- The Files property.

- La propiedad InputStream.- The InputStream property.

- El método GetBufferedInputStream().- The GetBufferedInputStream() method.

Para evitar esta excepción, llame primero al método ReadEntityBodyMode.To avoid this exception, call the ReadEntityBodyMode method first. Esta excepción también se produce si el cliente se desconecta mientras se está leyendo el cuerpo de la entidad.This exception is also thrown if the client disconnects while the entity body is being read.

Comentarios

Para obtener más información sobre este método, vea la GetBufferlessInputStream() sobrecarga.For more information about this method, see the GetBufferlessInputStream() overload.

Consulte también

Se aplica a