HttpRequest.GetBufferlessInputStream Метод

Определение

Пространство имен:

System.Web

Сборка:

System.Web.dll

Stream Возвращает объект, который можно использовать для чтения входящего текста сущности HTTP.

Перегрузки

Имя	Описание
GetBufferlessInputStream()	Stream Возвращает объект, который можно использовать для чтения входящего текста сущности HTTP.
GetBufferlessInputStream(Boolean)	Stream Возвращает объект, который можно использовать для чтения входящего текста сущности HTTP, при необходимости отключая ограничение длины запроса, заданное в свойствеMaxRequestLength.

GetBufferlessInputStream()

Stream Возвращает объект, который можно использовать для чтения входящего текста сущности HTTP.

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

public System.IO.Stream GetBufferlessInputStream();

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

Public Function GetBufferlessInputStream () As Stream

Возвращаемое значение

Stream

Stream Объект, который можно использовать для чтения входящего текста сущности HTTP.

Исключения

HttpException

Тело сущности запроса уже загружено и проанализировано. Примеры свойств, которые вызывают загрузку и синтаксический анализ тела сущности, включают следующие:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Чтобы избежать этого исключения, сначала вызовите ReadEntityBodyMode метод. Это исключение также возникает, если клиент отключается во время чтения тела сущности.

Комментарии

Этот метод предоставляет альтернативу использованию InputStream свойства. Свойство InputStream ожидает получения всего запроса, прежде чем он возвращает Stream объект. Напротив, GetBufferlessInputStream метод немедленно возвращает Stream объект. Метод можно использовать для начала обработки тела сущности до получения полного содержимого тела.

Тело сущности (или столько, сколько из него запрашивается и получено) возвращается только при использовании объекта, возвращаемого этим методом для чтения потока, путем вызова таких методов, как Read метод. Параметры метода используются для указания количества операций Read чтения текста сущности.

Объект, Stream возвращаемый ASP.NET из этого метода, поддерживает синхронные и асинхронные методы чтения. Объект Stream реализует как методы, так BeginRead и EndRead методы. Асинхронные методы позволяют асинхронно считывать сущность запроса в блоках, а ASP.NET освобождает текущий поток между каждой итерацией асинхронного цикла чтения.

Этот метод может быть полезен, если запрос отправляет большой файл, и вы хотите начать доступ к содержимому файла до завершения отправки. Однако этот метод следует использовать только для сценариев, где требуется взять на себя всю обработку тела сущности. Это означает, что этот метод нельзя использовать на странице .aspx, так как к моменту запуска страницы .aspx текст сущности уже считывается.

См. также раздел

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

Stream Возвращает объект, который можно использовать для чтения входящего текста сущности HTTP, при необходимости отключая ограничение длины запроса, заданное в свойстве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

Параметры

disableMaxRequestLength

Boolean

true отключение ограничения длины запроса; falseв противном случае .

Возвращаемое значение

Stream

Stream Объект, который можно использовать для чтения входящего текста сущности HTTP.

Исключения

HttpException

Тело сущности запроса уже загружено и проанализировано. Примеры свойств, которые вызывают загрузку и синтаксический анализ тела сущности, включают следующие:

• Свойство Form.

• Свойство Files.

• Свойство InputStream.

• Метод GetBufferedInputStream().

Чтобы избежать этого исключения, сначала вызовите ReadEntityBodyMode метод. Это исключение также возникает, если клиент отключается во время чтения тела сущности.

Комментарии

Дополнительные сведения об этом методе см. в разделе перегрузки GetBufferlessInputStream() .

См. также раздел

• GetBufferedInputStream()