HttpRequest.GetBufferlessInputStream Metoda

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Stream Získá objekt, který lze použít ke čtení textu příchozí entity HTTP.

Přetížení

Name	Description
GetBufferlessInputStream()	Stream Získá objekt, který lze použít ke čtení textu příchozí entity HTTP.
GetBufferlessInputStream(Boolean)	Stream Získá objekt, který lze použít ke čtení textu příchozí entity HTTP, volitelně zakázání limitu délky požadavku, který je nastaven ve MaxRequestLength vlastnosti.

GetBufferlessInputStream()

Stream Získá objekt, který lze použít ke čtení textu příchozí entity HTTP.

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

public System.IO.Stream GetBufferlessInputStream();

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

Public Function GetBufferlessInputStream () As Stream

Návraty

Stream

Objekt Stream , který lze použít ke čtení textu příchozí entity HTTP.

Výjimky

HttpException

Tělo entity požadavku již bylo načteno a analyzováno. Mezi příklady vlastností, které způsobují načtení a parsování těla entity, patří:

• Form

• InputStream

• Files

• GetBufferedInputStream()

Pokud se chcete této výjimce vyhnout, nejprve volejte metodu ReadEntityBodyMode . Tato výjimka se vyvolá také v případě, že se klient odpojí při čtení těla entity.

Poznámky

Tato metoda poskytuje alternativu InputStream k použití vlastnosti. Vlastnost InputStream čeká na přijetí celého požadavku, než vrátí Stream objekt. Naproti tomu GetBufferlessInputStream metoda vrátí Stream objekt okamžitě. Metodu můžete použít k zahájení zpracování těla entity před tím, než byl přijat úplný obsah těla.

Tělo entity (nebo co nejvíce z toho, co požadujete a bylo přijato) se vrátí pouze v případě, že použijete objekt vrácený touto metodou ke čtení datového proudu voláním metod, jako Read je metoda. Pomocí parametrů Read metody určíte, kolik těla entity se má číst.

Objekt Stream vrácený ASP.NET z této metody podporuje synchronní i asynchronní metody čtení. Objekt Stream implementuje jak metody BeginReadEndRead , tak i metody. Asynchronní metody umožňují asynchronně číst entitu požadavku v blocích, zatímco ASP.NET uvolní aktuální vlákno mezi každou iterací asynchronní smyčky čtení.

Tato metoda může být užitečná, pokud požadavek nahrává velký soubor a chcete začít přistupovat k obsahu souboru před dokončením nahrávání. Tuto metodu byste ale měli použít pouze ve scénářích, ve kterých chcete převzít veškeré zpracování těla entity. To znamená, že tuto metodu nelze použít z .aspx stránky, protože po spuštění .aspx stránky už tělo entity bylo přečteno.

Viz také

• GetBufferedInputStream()

GetBufferlessInputStream(Boolean)

Stream Získá objekt, který lze použít ke čtení textu příchozí entity HTTP, volitelně zakázání limitu délky požadavku, který je nastaven ve MaxRequestLength vlastnosti.

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

truek zakázání limitu délky požadavku; v opačném případě . false

Návraty

Stream

Objekt Stream , který lze použít ke čtení textu příchozí entity HTTP.

Výjimky

HttpException

Tělo entity požadavku již bylo načteno a analyzováno. Mezi příklady vlastností, které způsobují načtení a parsování těla entity, patří:

• Vlastnost Form.

• Vlastnost Files.

• Vlastnost InputStream.

• Metoda GetBufferedInputStream().

Pokud se chcete této výjimce vyhnout, nejprve volejte metodu ReadEntityBodyMode . Tato výjimka se vyvolá také v případě, že se klient odpojí při čtení těla entity.

Poznámky

Další informace o této metodě naleznete v GetBufferlessInputStream() přetížení.

Viz také

• GetBufferedInputStream()