HttpRequest.GetBufferedInputStream Method

Definition

Namespace:

System.Web

Assembly:

System.Web.dll

Gets a Stream object that can be used to read the incoming HTTP entity body.

public:
 System::IO::Stream ^ GetBufferedInputStream();

public System.IO.Stream GetBufferedInputStream ();

member this.GetBufferedInputStream : unit -> System.IO.Stream

Public Function GetBufferedInputStream () As Stream

Returns

Stream

A Stream object that can be used to read the incoming HTTP entity body.

Exceptions

HttpException

The request's entity body has already been loaded and parsed. Examples of properties that cause the entity body to be loaded and parsed include the following:

• The Form property.

• The Files property.

• The InputStream property.

• The GetBufferlessInputStream() method.

To avoid this exception, call the ReadEntityBodyMode method first. This exception is also thrown if the client disconnects while the entity body is being read.

Remarks

This method is identical to GetBufferlessInputStream except that it also copies the bytes that are read to the internal storage that is used by ASP.NET to populate the Form, Files, and InputStream properties. Because this information is preserved, downstream code such as ASP.NET Web Forms pages (.aspx files) will run successfully. This is not the case with the GetBufferlessInputStream method.