HttpRequest.GetBufferlessInputStream Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten.
Överlagringar
| Name | Description |
|---|---|
| GetBufferlessInputStream() |
Hämtar ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten. |
| GetBufferlessInputStream(Boolean) |
Hämtar ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten MaxRequestLength , om du vill inaktivera gränsen för begärans längd som anges i egenskapen. |
GetBufferlessInputStream()
Hämtar ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten.
public:
System::IO::Stream ^ GetBufferlessInputStream();
public System.IO.Stream GetBufferlessInputStream();
member this.GetBufferlessInputStream : unit -> System.IO.Stream
Public Function GetBufferlessInputStream () As Stream
Returer
Ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten.
Undantag
Begärans entitetstext har redan lästs in och parsats. Exempel på egenskaper som gör att entitetstexten läses in och parsas är följande:
Om du vill undvika det här undantaget anropar du ReadEntityBodyMode metoden först. Det här undantaget utlöses också om klienten kopplas från medan entitetstexten läses.
Kommentarer
Den här metoden är ett alternativ till att använda egenskapen InputStream . Egenskapen InputStream väntar tills hela begäran har tagits emot innan den returnerar ett Stream objekt. Metoden returnerar GetBufferlessInputStream däremot Stream objektet omedelbart. Du kan använda metoden för att börja bearbeta entitetstexten innan det fullständiga innehållet i brödtexten har tagits emot.
Entitetstexten (eller så mycket av den som du begär och har tagit emot) returneras endast när du använder objektet som returneras av den här metoden för att läsa dataströmmen genom att anropa metoder som Read metoden. Du använder parametrar för Read metoden för att ange hur mycket av entitetstexten som ska läsas.
Objektet Stream som returneras av ASP.NET från den här metoden stöder både synkrona och asynkrona läsmetoder. Objektet Stream implementerar både BeginRead metoderna och EndRead . Med asynkrona metoder kan du asynkront läsa begärandeentiteten i segment, medan ASP.NET släpper den aktuella tråden mellan varje iteration av en asynkron läsloop.
Den här metoden kan vara användbar om begäran laddar upp en stor fil och du vill börja komma åt filinnehållet innan uppladdningen är klar. Du bör dock bara använda den här metoden för scenarier där du vill ta över all bearbetning av entitetstexten. Det innebär att du inte kan använda den här metoden från en .aspx sida, eftersom entitetstexten redan har lästs när en .aspx sida körs.
Se även
Gäller för
GetBufferlessInputStream(Boolean)
Hämtar ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten MaxRequestLength , om du vill inaktivera gränsen för begärans längd som anges i egenskapen.
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
Parametrar
- disableMaxRequestLength
- Boolean
trueför att inaktivera gränsen för begärandelängd. annars . false
Returer
Ett Stream objekt som kan användas för att läsa den inkommande HTTP-entitetstexten.
Undantag
Begärans entitetstext har redan lästs in och parsats. Exempel på egenskaper som gör att entitetstexten läses in och parsas är följande:
Egenskapen Form.
Egenskapen Files.
Egenskapen InputStream.
GetBufferedInputStream()-metoden.
Om du vill undvika det här undantaget anropar du ReadEntityBodyMode metoden först. Det här undantaget utlöses också om klienten kopplas från medan entitetstexten läses.
Kommentarer
Mer information om den här metoden finns i överlagringen GetBufferlessInputStream() .