HttpRequest.InsertEntityBody 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.
Stellt einen verwalteten Wrapper für die IIS-Methode bereit, mit der ein HTTP-Anforderungs-Einheitstextkörper in den Arbeitsspeicher eingefügt wird.
Überlädt
| InsertEntityBody() |
Stellt für IIS eine Kopie des HTTP-Anforderungs-Einheitstextkörpers bereit. |
| InsertEntityBody(Byte[], Int32, Int32) |
Stellt für IIS eine Kopie des HTTP-Anforderungs-Einheitstextkörpers und Informationen zum Anforderungsentitätsobjekt bereit. |
Hinweise
Die InsertEntityBody Methodenüberladungen bieten verwalteten Zugriff auf die IIS 7-Methode IHttpRequest::InsertEntityBody . Die IIS-Methode fügt einen HTTP-Anforderungs-Entitätstext (die Von einem Client bereitgestellten Daten) in den Arbeitsspeicher ein. Dies ist nützlich, da IIS keine Kopie der Anforderungsentität verwaltet, nachdem sie gelesen wurde. Die InsertEntityBody Methoden erstellen eine Kopie der HTTP-Anforderungs-Entitätsdaten und stellen sie für zusätzliche benutzerdefinierte Behandlung für IIS zur Verfügung.
Hinweis
Die Methodenüberladungen funktionieren nur für IIS 7.0 oder höher, da die InsertEntityBody IHttpRequest::InsertEntityBody Methode in IIS 7.0 hinzugefügt wurde.
InsertEntityBody()
Stellt für IIS eine Kopie des HTTP-Anforderungs-Einheitstextkörpers bereit.
public:
void InsertEntityBody();public void InsertEntityBody ();member this.InsertEntityBody : unit -> unitPublic Sub InsertEntityBody ()Ausnahmen
Die Methode wurde für eine frühere Version von IIS als IIS 7.0 aufgerufen.
Hinweise
IIS verwaltet keine Kopie der Anforderung, nachdem sie gelesen wurde. Daher wird empfohlen, dass nur der Handler für eine HTTP-Anforderung die Anforderungs entität lesen sollte.
Die HttpRequest.InsertEntityBody Methodenüberladung stellt IIS mit einer Kopie der Anforderungsentität bereit, wenn sie zuvor von ASP.NET gelesen wurde. Diese Methodenüberladung ist nützlich für Fälle, in denen ASP.NET die Entitätsanforderung gelesen hat und Sie die vorhandenen Anforderungsdaten wiederverwenden möchten.
Gilt für
InsertEntityBody(Byte[], Int32, Int32)
Stellt für IIS eine Kopie des HTTP-Anforderungs-Einheitstextkörpers und Informationen zum Anforderungsentitätsobjekt bereit.
public:
void InsertEntityBody(cli::array <System::Byte> ^ buffer, int offset, int count);public void InsertEntityBody (byte[] buffer, int offset, int count);member this.InsertEntityBody : byte[] * int * int -> unitPublic Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)Parameter
- buffer
- Byte[]
Ein Array, das die Anforderungsentitätsdaten enthält.
- offset
- Int32
Die nullbasierte Position im buffer-Parameter, an der das Speichern der Anforderungsentitätsdaten beginnen soll.
- count
- Int32
Die Anzahl der in das buffer-Array zu lesenden Bytes.
Ausnahmen
Die Methode wurde für eine frühere Version von IIS als IIS 7.0 aufgerufen.
buffer ist null.
offset oder count ist ein negativer Wert.
Die Elementzahl in count ist größer als der verfügbare Platz in buffer, wenn der offset-Wert angegeben ist.
Hinweise
IIS verwaltet keine Kopie der Anforderung, nachdem sie gelesen wurde. Daher wird empfohlen, dass nur der Handler für eine HTTP-Anforderung die Anforderungs entität lesen sollte.
Die HttpRequest.InsertEntityBody Methodenüberladung ist nützlich, wenn Sie benutzerdefinierte Verarbeitung ausführen möchten, z. B. das Einfügen eines anderen Entitätstexts in den Arbeitsspeicher.