HttpRequest.GetBufferlessInputStream Methode

Definition

Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.Gets a Stream object that can be used to read the incoming HTTP entity body.

Überlädt

GetBufferlessInputStream()

Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.Gets a Stream object that can be used to read the incoming HTTP entity body.

GetBufferlessInputStream(Boolean)

Ruft ein Stream-Objekt ab, das verwendet werden kann, um den eingehenden HTTP-Entitätstexts zu lesen, wobei optional die Anforderungslängenbegrenzung deaktiviert wird, die in der MaxRequestLength-Eigenschaft festgesetzt ist.Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

GetBufferlessInputStream()

Ruft ein Stream-Objekt ab, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.Gets a Stream object that can be used to read the incoming HTTP entity body.

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ätentexts verwendet werden kann.A Stream object that can be used to read the incoming HTTP entity body.

Ausnahmen

Der Entitätstext der Anforderung wurde bereits geladen und wurde analysiert.The request's entity body has already been loaded and parsed. Beispiele für Eigenschaften, die das Laden und Analysieren des Entitätstexts verursachen, umfassen Folgende:Examples of properties that cause the entity body to be loaded and parsed include the following:

Um diese Ausnahme zu vermeiden, rufen Sie die ReadEntityBodyMode-Methode zuerst auf.To avoid this exception, call the ReadEntityBodyMode method first. Diese Ausnahme wird auch ausgelöst, wenn der Client getrennt wird, während der Entitätstext gelesen wird.This exception is also thrown if the client disconnects while the entity body is being read.

Hinweise

Diese Methode bietet eine Alternative zur Verwendung der InputStream -Eigenschaft.This method provides an alternative to using the InputStream property. Die InputStream -Eigenschaft wartet, bis die gesamte Anforderung empfangen wurde, bevor Sie Stream ein-Objekt zurückgibt.The InputStream property waits until the whole request has been received before it returns a Stream object. Im Gegensatz dazu gibt GetBufferlessInputStream die-Methode Stream das-Objekt sofort zurück.In contrast, the GetBufferlessInputStream method returns the Stream object immediately. Sie können die-Methode verwenden, um mit der Verarbeitung des Entitäts Texts zu beginnen, bevor der gesamte Inhalt des Texts empfangen wurde.You can use the method to begin processing the entity body before the complete contents of the body have been received.

Der Entitäts Text (oder so viel, wie Sie anfordern und empfangen wurde) wird nur zurückgegeben, wenn Sie das Objekt, das von dieser Methode zurückgegeben wird, zum Lesen des Streams verwenden, indem Sie Read Methoden wie die-Methode aufrufen.The entity body (or as much of it as you request and has been received) is returned only when you use the object that is returned by this method to read the stream, by calling methods such as the Read method. Sie verwenden Parameter der Read -Methode, um anzugeben, wie viel der zu lesenden Entitäts Text ist.You use parameters of the Read method to specify how much of the entity body to read.

Das Stream von der ASP.NET-Methode zurückgegebene-Objekt unterstützt synchrone und asynchrone Lesemethoden.The Stream object returned by ASP.NET from this method supports both synchronous and asynchronous read methods. Das Stream -Objekt implementiert die BeginRead - EndRead Methode und die-Methode.The Stream object implements both the BeginRead and EndRead methods. Mit den asynchronen Methoden können Sie die Anforderungs Entität asynchron in Blöcken lesen, während ASP.NET den aktuellen Thread zwischen den einzelnen Iterationen einer asynchronen Lese Schleife freigibt.The asynchronous methods let you asynchronously read the request entity in chunks, while ASP.NET releases the current thread in between each iteration of an asynchronous read loop.

Diese Methode kann nützlich sein, wenn die Anforderung eine große Datei hochlädt und Sie auf den Dateiinhalt zugreifen möchten, bevor der Upload abgeschlossen ist.This method can be useful if the request is uploading a large file and you want to begin accessing the file contents before the upload is finished. Sie sollten diese Methode jedoch nur für Szenarien verwenden, in denen Sie die gesamte Verarbeitung des Entitäts Texts übernehmen möchten.However, you should only use this method for scenarios where you want to take over all processing of the entity body. Dies bedeutet, dass Sie diese Methode nicht von einer ASPX-Seite aus verwenden können, da der Entitäts Text beim Ausführen einer ASPX-Seite bereits gelesen wurde.This means that you cannot use this method from an .aspx page, because by the time an .aspx page runs, the entity body has already been read.

Siehe auch

GetBufferlessInputStream(Boolean)

Ruft ein Stream-Objekt ab, das verwendet werden kann, um den eingehenden HTTP-Entitätstexts zu lesen, wobei optional die Anforderungslängenbegrenzung deaktiviert wird, die in der MaxRequestLength-Eigenschaft festgesetzt ist.Gets a Stream object that can be used to read the incoming HTTP entity body, optionally disabling the request-length limit that is set in the MaxRequestLength property.

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

disableMaxRequestLength
Boolean

true, um die Längenbeschränkung der Anforderung zu deaktivieren; andernfalls false.true to disable the request-length limit; otherwise, false.

Gibt zurück

Ein Stream-Objekt, das zum Lesen des eingehenden HTTP-Entitätentexts verwendet werden kann.A Stream object that can be used to read the incoming HTTP entity body.

Ausnahmen

Der Entitätstext der Anforderung wurde bereits geladen und wurde analysiert.The request's entity body has already been loaded and parsed. Beispiele für Eigenschaften, die das Laden und Analysieren des Entitätstexts verursachen, umfassen Folgende:Examples of properties that cause the entity body to be loaded and parsed include the following: – Die Form-Eigenschaft.- The Form property.

– Die Files-Eigenschaft.- The Files property.

– Die InputStream-Eigenschaft.- The InputStream property.

– Die GetBufferedInputStream()-Methode.- The GetBufferedInputStream() method.

Um diese Ausnahme zu vermeiden, rufen Sie die ReadEntityBodyMode-Methode zuerst auf.To avoid this exception, call the ReadEntityBodyMode method first. Diese Ausnahme wird auch ausgelöst, wenn der Client getrennt wird, während der Entitätstext gelesen wird.This exception is also thrown if the client disconnects while the entity body is being read.

Hinweise

Weitere Informationen zu dieser Methode finden Sie unter GetBufferlessInputStream() Überladung.For more information about this method, see the GetBufferlessInputStream() overload.

Siehe auch

Gilt für: