HttpRequest.GetBufferlessInputStream Metódus

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Lekéri a Stream bejövő HTTP-entitás törzsének olvasására használható objektumot.

Túlterhelések

Name	Description
GetBufferlessInputStream()	Lekéri a Stream bejövő HTTP-entitás törzsének olvasására használható objektumot.
GetBufferlessInputStream(Boolean)	Stream Lekéri a bejövő HTTP-entitás törzsének olvasására használható objektumot, amely letiltja a tulajdonságban MaxRequestLength beállított kérelemhossz-korlátot.

GetBufferlessInputStream()

Lekéri a Stream bejövő HTTP-entitás törzsének olvasására használható objektumot.

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

public System.IO.Stream GetBufferlessInputStream();

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

Public Function GetBufferlessInputStream () As Stream

Válaszok

Stream

A Stream bejövő HTTP-entitás törzsének olvasására használható objektum.

Kivételek

HttpException

A kérelem entitástörzse már be lett töltve és elemezve. Az entitás törzsének betöltését és elemzését okozó tulajdonságok például a következők:

A kivétel elkerülése érdekében először hívja meg a metódust ReadEntityBodyMode . Ez a kivétel akkor is megjelenik, ha az ügyfél az entitás törzsének olvasása közben megszakad.

Megjegyzések

Ez a módszer alternatívát kínál a InputStream tulajdonság használatára. A InputStream tulajdonság megvárja, amíg a teljes kérelem meg nem érkezik, mielőtt visszaad egy objektumot Stream . Ezzel szemben a GetBufferlessInputStream metódus azonnal visszaadja az Stream objektumot. A metódussal megkezdheti az entitás törzsének feldolgozását a törzs teljes tartalmának beérkezése előtt.

Az entitás törzse (vagy annak a kérése és fogadása) csak akkor lesz visszaadva, ha a metódus által visszaadott objektumot használja a stream olvasásához, olyan metódusok meghívásával, mint a Read metódus. A metódus paramétereivel megadhatja, Read hogy az entitás törzsének mekkora részét olvassa be.

A ASP.NET által visszaadott Stream objektum támogatja a szinkron és az aszinkron olvasási metódusokat is. Az Stream objektum implementálja a metódusokat és BeginRead a EndRead metódusokat is. Az aszinkron metódusokkal aszinkron módon olvashatja be a kérelementitást adattömbökben, míg ASP.NET az aktuális szálat egy aszinkron olvasási ciklus egyes iterációi között oldja fel.

Ez a módszer akkor lehet hasznos, ha a kérelem egy nagy fájlt tölt fel, és a feltöltés befejezése előtt hozzá szeretne férni a fájl tartalmához. Ezt a módszert azonban csak olyan helyzetekben érdemes használni, ahol át szeretné venni az entitás törzsének összes feldolgozását. Ez azt jelenti, hogy ezt a metódust nem használhatja .aspx lapról, mert egy .aspx lap futtatásakor az entitás törzse már beolvasva.

Lásd még

GetBufferedInputStream()

A következőre érvényes:

GetBufferlessInputStream(Boolean)

Stream Lekéri a bejövő HTTP-entitás törzsének olvasására használható objektumot, amely letiltja a tulajdonságban MaxRequestLength beállított kérelemhossz-korlátot.

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

Paraméterek

disableMaxRequestLength: Boolean

truea kérelemhossz-korlátozás letiltása; egyéb esetben. false