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-Entitätstexts 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 ein Stream Objekt zurückgegeben wird. 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 Textkörpers empfangen wurde.

Der Entitätstext (oder so viel davon, wie Sie anfordern und empfangen wurden) wird nur zurückgegeben, wenn Sie das Objekt verwenden, das von dieser Methode zurückgegeben wird, um den Datenstrom zu lesen, indem Methoden wie die Read Methode aufgerufen werden. Sie verwenden Parameter der Read Methode, um anzugeben, wie viel der Zu lesende Entitätstext ist.

Das Stream von ASP.NET von dieser Methode zurückgegebene Objekt unterstützt synchrone und asynchrone Lesemethoden. Das Stream Objekt implementiert sowohl die Methoden als EndRead auch die BeginRead Methoden. 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 die Dateiinhalte 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 bereits gelesen wurde, wenn eine .aspx Seite ausgeführt wird.

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-Entitätstexts verwendet werden kann.

Ausnahmen

Hinweise

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

Weitere Informationen

• GetBufferedInputStream()