HttpRequest.GetBufferlessInputStream Metoda

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

public System.IO.Stream GetBufferlessInputStream ();

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

Public Function GetBufferlessInputStream () As Stream

Zwraca

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

Wyjątki

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()

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

Zwraca

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

Wyjątki

Uwagi

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

Zobacz też

• GetBufferedInputStream()