HttpRequest.InsertEntityBody Methode

Definition

Stellt einen verwalteten Wrapper für die IIS-Methode bereit, mit der ein HTTP-Anforderungsentitätstext in den Arbeitsspeicher eingefügt wird.Provides a managed wrapper for the IIS method that inserts an HTTP request entity body into memory.

Überlädt

InsertEntityBody()

Stellt für IIS eine Kopie des HTTP-Anforderungseinheitentexts bereit.Provides IIS with a copy of the HTTP request entity body.

InsertEntityBody(Byte[], Int32, Int32)

Stellt für IIS eine Kopie des HTTP-Anforderungseinheitentexts und Informationen zum Anforderungsentitätsobjekt bereit.Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

Hinweise

Die InsertEntityBody Methoden Überladungen bieten verwalteten Zugriff auf die IIS 7 IHttpRequest::InsertEntityBody -Methode.The InsertEntityBody method overloads provide managed access to the IIS 7 IHttpRequest::InsertEntityBody method. Die IIS-Methode fügt einen HTTP-Anforderungs Entitäts Text (die Daten, die von einem Client gesendet werden) in den Arbeitsspeicher ein.The IIS method inserts an HTTP request entity body (the data that is posted by a client) into memory. Dies ist hilfreich, da IIS eine Kopie der Anforderungs Entität nicht verwaltet, nachdem Sie gelesen wurde.This is useful because IIS does not maintain a copy of the request entity after it has been read. Die InsertEntityBody -Methoden erstellen eine Kopie der HTTP-Anforderungs Entitäts Daten und stellen Sie für IIS zur weiteren benutzerdefinierten Behandlung zur Verfügung.The InsertEntityBody methods create a copy of the HTTP request entity data and make it available to IIS for additional custom handling.

Hinweis

Die InsertEntityBody -Methoden Überladungen funktionieren nur unter IIS 7,0 oder höher, da IHttpRequest::InsertEntityBody die-Methode in IIS 7,0 hinzugefügt wurde.The InsertEntityBody method overloads work only on IIS 7.0 or later, because the IHttpRequest::InsertEntityBody method was added in IIS 7.0.

InsertEntityBody()

Stellt für IIS eine Kopie des HTTP-Anforderungseinheitentexts bereit.Provides IIS with a copy of the HTTP request entity body.

public:
 void InsertEntityBody();
public void InsertEntityBody ();
member this.InsertEntityBody : unit -> unit
Public Sub InsertEntityBody ()

Ausnahmen

Die Methode wurde für eine frühere Version von IIS als IIS 7.0 aufgerufen.The method was invoked on a version of IIS earlier than IIS 7.0.

Hinweise

IIS behält keine Kopie der Anforderung bei, nachdem Sie gelesen wurde.IIS does not maintain a copy of the request after it has been read. Daher wird empfohlen, dass nur der Handler für eine HTTP-Anforderung die Anforderungs Entität lesen soll.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

Die HttpRequest.InsertEntityBody -Methoden Überladung bietet IIS eine Kopie der Anforderungs Entität, wenn Sie zuvor von ASP.net gelesen wurde.The HttpRequest.InsertEntityBody method overload provides IIS with a copy of the request entity if it was previously read by ASP.NET. Diese Methoden Überladung ist in Fällen nützlich, in denen ASP.net die Entitäts Anforderung gelesen hat und Sie die vorhandenen Anforderungs Daten wieder verwenden möchten.This method overload is useful for cases where ASP.NET has read the entity request and you want to reuse the existing request data.

Sicherheit

AspNetHostingPermission
Für den Betrieb in einer gehosteten Umgebung.For operating in a hosted environment. Sicherheitsaktion: Demand.Security action: Demand. Zugehörige Enumeration:HighAssociated enumeration: High

InsertEntityBody(Byte[], Int32, Int32)

Stellt für IIS eine Kopie des HTTP-Anforderungseinheitentexts und Informationen zum Anforderungsentitätsobjekt bereit.Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

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 -> unit
Public Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)

Parameter

buffer
Byte[]

Ein Array, das die Anforderungsentitätsdaten enthält.An array that contains the request entity data.

offset
Int32

Die nullbasierte Position im buffer-Parameter, an der das Speichern der Anforderungsentitätsdaten beginnen soll.The zero-based position in buffer at which to begin storing the request entity data.

count
Int32

Die Anzahl der in den buffer-Array zu lesenden Bytes.The number of bytes to read into the buffer array.

Ausnahmen

Die Methode wurde für eine frühere Version von IIS als IIS 7.0 aufgerufen.The method was invoked on a version of IIS earlier than IIS 7.0.

buffer ist null.buffer is null.

offset oder count ist ein negativer Wert.offset or count is a negative value.

Die Elementzahl in count ist größer als der verfügbare Platz in buffer, wenn der offset-Wert angegeben ist.The number of items in count is larger than the available space in buffer, given the offset value.

Hinweise

IIS behält keine Kopie der Anforderung bei, nachdem Sie gelesen wurde.IIS does not maintain a copy of the request after it has been read. Daher wird empfohlen, dass nur der Handler für eine HTTP-Anforderung die Anforderungs Entität lesen soll.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

Die HttpRequest.InsertEntityBody -Methoden Überladung ist nützlich, wenn Sie eine benutzerdefinierte Verarbeitung durchführen möchten, z. b. einen anderen Entitäts Text in den Arbeitsspeicher einfügenThe HttpRequest.InsertEntityBody method overload is useful when you want to perform custom processing, such as inserting a different entity body into memory.

Sicherheit

AspNetHostingPermission
für den Betrieb in einer Hostumgebung.for operating in a hosted environment. Sicherheitsaktion: Demand.Security action: Demand. Zugehörige Enumeration:HighAssociated enumeration: High

Gilt für: