HttpRequest.GetBufferlessInputStream Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.
Überlädt
| GetBufferlessInputStream() |
Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann. |
| GetBufferlessInputStream(Boolean) |
Ruft ein Stream-Objekt ab, das verwendet werden kann, um den eingehenden HTTP-Einheitstextkörper zu lesen, wobei optional die Anforderungslängenbegrenzung deaktiviert wird, die in der MaxRequestLength-Eigenschaft festgesetzt ist. |
GetBufferlessInputStream()
Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.
public:
System::IO::Stream ^ GetBufferlessInputStream();public System.IO.Stream GetBufferlessInputStream ();member this.GetBufferlessInputStream : unit -> System.IO.StreamPublic Function GetBufferlessInputStream () As StreamGibt zurück
Ein Stream-Objekt, das zum Lesen des eingehenden HTTP-Einheitstextkörpers verwendet werden kann.
Ausnahmen
Der Entitätstext der Anforderung wurde bereits geladen und wurde analysiert. Beispiele für Eigenschaften, die das Laden und Analysieren des Entitätstexts verursachen, umfassen Folgende:
Um diese Ausnahme zu vermeiden, rufen Sie die ReadEntityBodyMode-Methode zuerst auf. Diese Ausnahme wird auch ausgelöst, wenn der Client getrennt wird, während der Entitätstext gelesen wird.
Hinweise
Diese Methode stellt eine Alternative zur Verwendung der InputStream -Eigenschaft bereit. Die InputStream -Eigenschaft wartet, bis die gesamte Anforderung empfangen wurde, bevor sie ein Stream -Objekt zurückgibt. Im Gegensatz dazu gibt die GetBufferlessInputStream -Methode das Stream -Objekt sofort zurück. Sie können die -Methode verwenden, um mit der Verarbeitung des Entitätstexts zu beginnen, bevor der vollständige Inhalt des Texts empfangen wurde.
Der Entitätstext (oder so viel davon, wie Sie anfordern und empfangen haben) wird nur zurückgegeben, wenn Sie das von dieser Methode zurückgegebene Objekt zum Lesen des Datenstroms verwenden, indem Sie Methoden wie die Read -Methode aufrufen. Sie verwenden Parameter der Read -Methode, um anzugeben, wie viel des Entitätstexts gelesen werden soll.
Das Stream von ASP.NET von dieser Methode zurückgegebene Objekt unterstützt sowohl synchrone als auch asynchrone Lesemethoden. Das Stream -Objekt implementiert sowohl die -EndReadMethode als auch die BeginRead -Methode. Mit den asynchronen Methoden können Sie die Anforderungsentität in Blöcken asynchron lesen, während ASP.NET den aktuellen Thread zwischen jeder Iteration einer asynchronen Leseschleife freigibt.
Diese Methode kann nützlich sein, wenn die Anforderung eine große Datei hochlädt und Sie mit dem Zugriff auf den Dateiinhalt beginnen möchten, bevor der Upload abgeschlossen ist. Sie sollten diese Methode jedoch nur für Szenarien verwenden, in denen Sie die gesamte Verarbeitung des Entitätstexts übernehmen möchten. Dies bedeutet, dass Sie diese Methode nicht von einer ASPX-Seite verwenden können, da der Entitätstext zum Zeitpunkt der Ausführung einer ASPX-Seite bereits gelesen wurde.
Weitere Informationen
Gilt für:
GetBufferlessInputStream(Boolean)
Ruft ein Stream-Objekt ab, das verwendet werden kann, um den eingehenden HTTP-Einheitstextkörper zu lesen, wobei optional die Anforderungslängenbegrenzung deaktiviert wird, die in der MaxRequestLength-Eigenschaft festgesetzt ist.
public:
System::IO::Stream ^ GetBufferlessInputStream(bool disableMaxRequestLength);public System.IO.Stream GetBufferlessInputStream (bool disableMaxRequestLength);member this.GetBufferlessInputStream : bool -> System.IO.StreamPublic Function GetBufferlessInputStream (disableMaxRequestLength As Boolean) As StreamParameter
- disableMaxRequestLength
- Boolean
true, um die Längenbeschränkung der Anforderung zu deaktivieren, andernfalls false.
Gibt zurück
Ein Stream-Objekt, das zum Lesen des eingehenden HTTP-Einheitstextkörpers verwendet werden kann.
Ausnahmen
Der Entitätstext der Anforderung wurde bereits geladen und wurde analysiert. Beispiele für Eigenschaften, die das Laden und Analysieren des Entitätstexts verursachen, umfassen Folgende:
Die Form-Eigenschaft
Die Files-Eigenschaft
Die InputStream-Eigenschaft
Die GetBufferedInputStream() -Methode.
Um diese Ausnahme zu vermeiden, rufen Sie die ReadEntityBodyMode-Methode zuerst auf. Diese Ausnahme wird auch ausgelöst, wenn der Client getrennt wird, während der Entitätstext gelesen wird.
Hinweise
Weitere Informationen zu dieser Methode finden Sie in der GetBufferlessInputStream() Überladung.
