HttpRequest.GetBufferlessInputStream HttpRequest.GetBufferlessInputStream HttpRequest.GetBufferlessInputStream HttpRequest.GetBufferlessInputStream Method

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() GetBufferlessInputStream() GetBufferlessInputStream() 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) GetBufferlessInputStream(Boolean) GetBufferlessInputStream(Boolean) 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() GetBufferlessInputStream() GetBufferlessInputStream() 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 eine Rückgabe einer Stream Objekt.The InputStream property waits until the whole request has been received before it returns a Stream object. Im Gegensatz dazu die GetBufferlessInputStream Methode gibt die Stream sofort Objekt.In contrast, the GetBufferlessInputStream method returns the Stream object immediately. Sie können die Methode verwenden, um den Entitätstext verarbeiten, bevor Sie den vollständigen Inhalt des Nachrichtentexts empfangen wurden zu beginnen.You can use the method to begin processing the entity body before the complete contents of the body have been received.

Der einheitstextkörper (oder so viel, als Sie anfordern und empfangen wurde) wird nur zurückgegeben, wenn Sie das Objekt verwenden, wird durch diese Methode, um den Stream zu lesen, durch Aufrufen von Methoden wie z. B. zurückgegeben, die Read Methode.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. Verwenden Sie Parameter, der die Read Methode, um anzugeben, welcher Anteil der Entitätstext gelesen.You use parameters of the Read method to specify how much of the entity body to read.

Die Stream von ASP.NET aus dieser Methode zurückgegebene Objekt unterstützt die synchrone und asynchrone read-Methoden.The Stream object returned by ASP.NET from this method supports both synchronous and asynchronous read methods. Die Stream Objekt implementiert sowohl die BeginRead und EndRead Methoden.The Stream object implements both the BeginRead and EndRead methods. Die asynchronen Methoden können Sie die Anforderungsentität in Segmenten asynchron zu lesen, während ASP.NET zwischen jeder Iteration der einen asynchronen read-Schleife den aktuellen Thread frei.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 hochladen ist und Sie möchten, um zu beginnen, den Zugriff auf den Inhalt der Datei, 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, wo Sie die gesamte Verarbeitung des einheitstextkörpers ü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 aus einer ASPX-Seite, nicht verwenden können, da von der Ausführung eine ASPX-Seite, der einheitstextkörper 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) GetBufferlessInputStream(Boolean) GetBufferlessInputStream(Boolean) 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 Boolean Boolean 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 den GetBufferlessInputStream() überladen.For more information about this method, see the GetBufferlessInputStream() overload.

Siehe auch

Gilt für: