HttpRequest.GetBufferlessInputStream Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

Stream Pobiera obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP.

Przeciążenia

GetBufferlessInputStream()	Stream Pobiera obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP.
GetBufferlessInputStream(Boolean)	Stream Pobiera obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP, opcjonalnie wyłączając limit długości żądania ustawiony we MaxRequestLength właściwości.

GetBufferlessInputStream()

Stream Pobiera obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP.

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

public System.IO.Stream GetBufferlessInputStream ();

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

Public Function GetBufferlessInputStream () As Stream

Zwraca

Stream

Stream Obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP.

Wyjątki

HttpException

Treść jednostki żądania została już załadowana i przeanalizowana. Przykłady właściwości, które powodują załadowanie i przeanalizowanie treści jednostki, obejmują następujące elementy:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Aby uniknąć tego wyjątku, najpierw wywołaj metodę ReadEntityBodyMode . Ten wyjątek jest również zgłaszany, jeśli klient rozłącza się, gdy treść jednostki jest odczytywana.

Uwagi

Ta metoda stanowi alternatywę dla używania InputStream właściwości . Właściwość InputStream czeka na odebranie całego żądania przed zwróceniem Stream obiektu. GetBufferlessInputStream Natomiast metoda natychmiast zwraca Stream obiekt. Za pomocą metody można rozpocząć przetwarzanie treści jednostki przed odebraniem pełnej zawartości treści.

Treść jednostki (lub tyle, ile żądasz i została odebrana) jest zwracana tylko wtedy, gdy używasz obiektu zwróconego przez tę metodę, aby odczytać strumień, wywołując metody takie jak Read metoda. Parametry metody służą Read do określania ilości treści jednostki do odczytania.

Stream Obiekt zwrócony przez ASP.NET z tej metody obsługuje metody odczytu synchronicznego i asynchronicznego. Obiekt Stream implementuje metody BeginRead i .EndRead Metody asynchroniczne umożliwiają asynchronicznie odczytywanie jednostki żądania we fragmentach, podczas gdy ASP.NET zwalnia bieżący wątek między każdą iterację asynchronicznej pętli odczytu.

Ta metoda może być przydatna, jeśli żądanie przekazuje duży plik i chcesz rozpocząć uzyskiwanie dostępu do zawartości pliku przed zakończeniem przekazywania. Jednak należy użyć tej metody tylko w scenariuszach, w których chcesz przejąć wszystkie przetwarzanie treści jednostki. Oznacza to, że nie można użyć tej metody ze strony aspx, ponieważ po uruchomieniu strony aspx treść jednostki została już odczytana.

Zobacz też

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

Stream Pobiera obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP, opcjonalnie wyłączając limit długości żądania ustawiony we MaxRequestLength właściwości.

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

Parametry

disableMaxRequestLength

Boolean

true aby wyłączyć limit długości żądania; w przeciwnym razie , false.

Zwraca

Stream

Stream Obiekt, który może służyć do odczytywania przychodzącej treści jednostki HTTP.

Wyjątki

HttpException

Treść jednostki żądania została już załadowana i przeanalizowana. Przykłady właściwości, które powodują załadowanie i przeanalizowanie treści jednostki, obejmują następujące elementy:

• Właściwość Form .

• Właściwość Files .

• Właściwość InputStream .

• Metoda GetBufferedInputStream() .

Aby uniknąć tego wyjątku, najpierw wywołaj metodę ReadEntityBodyMode . Ten wyjątek jest również zgłaszany, jeśli klient rozłącza się, gdy treść jednostki jest odczytywana.

Uwagi

Aby uzyskać więcej informacji na temat tej metody, zobacz przeciążenie GetBufferlessInputStream() .

Zobacz też

• GetBufferedInputStream()