HttpRequest.GetBufferlessInputStream Methode

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

public System.IO.Stream GetBufferlessInputStream ();

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

Public Function GetBufferlessInputStream () As Stream

Gibt zurück

Ein Stream-Objekt, das zum Lesen des eingehenden HTTP-Einheitstextkörpers verwendet werden kann.

Ausnahmen

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

• 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

Parameter

Gibt zurück

Ein Stream-Objekt, das zum Lesen des eingehenden HTTP-Einheitstextkörpers verwendet werden kann.

Ausnahmen

Hinweise

Weitere Informationen zu dieser Methode finden Sie in der GetBufferlessInputStream() Überladung.

Weitere Informationen

• GetBufferedInputStream()