Condividi tramite


HttpRequest.InsertEntityBody Metodo

Definizione

Fornisce un wrapper gestito per il metodo IIS che inserisce un corpo dell'entità di richiesta HTTP in memoria.

Overload

InsertEntityBody()

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP.

InsertEntityBody(Byte[], Int32, Int32)

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP nonché le informazioni sull'oggetto entità di richiesta.

Commenti

Gli InsertEntityBody overload del metodo forniscono l'accesso gestito al metodo IIS 7 IHttpRequest::InsertEntityBody . Il metodo IIS inserisce un corpo dell'entità richiesta HTTP (i dati pubblicati da un client) in memoria. Questo è utile perché IIS non gestisce una copia dell'entità richiesta dopo la lettura. I InsertEntityBody metodi creano una copia dei dati dell'entità richiesta HTTP e lo rendono disponibile per IIS per una gestione personalizzata aggiuntiva.

Nota

Gli overload del InsertEntityBody metodo funzionano solo in IIS 7.0 o versioni successive, perché il IHttpRequest::InsertEntityBody metodo è stato aggiunto in IIS 7.0.

InsertEntityBody()

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP.

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

Eccezioni

Il metodo è stato richiamato su una versione di IIS precedente a IIS 7.0.

Commenti

IIS non gestisce una copia della richiesta dopo la lettura. È pertanto consigliabile leggere l'entità richiesta solo il gestore per una richiesta HTTP.

L'overload HttpRequest.InsertEntityBody del metodo fornisce IIS con una copia dell'entità richiesta se è stata letto in precedenza da ASP.NET. Questo overload di metodo è utile per i casi in cui ASP.NET ha letto la richiesta di entità e si vuole riutilizzare i dati delle richieste esistenti.

Si applica a

InsertEntityBody(Byte[], Int32, Int32)

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP nonché le informazioni sull'oggetto entità di richiesta.

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)

Parametri

buffer
Byte[]

Matrice che contiene i dati dell'entità di richiesta.

offset
Int32

Posizione in base zero in buffer in corrispondenza della quale iniziare ad archiviare i dati dell'entità di richiesta.

count
Int32

Numero di byte da leggere e archiviare nella matrice buffer.

Eccezioni

Il metodo è stato richiamato su una versione di IIS precedente a IIS 7.0.

buffer è null.

offset o count è un valore negativo.

Il numero di elementi nell'oggetto count è maggiore dello spazio disponibile in buffer, dato il valore di offset.

Commenti

IIS non gestisce una copia della richiesta dopo la lettura. È pertanto consigliabile leggere l'entità richiesta solo il gestore per una richiesta HTTP.

L'overload del HttpRequest.InsertEntityBody metodo è utile quando si vuole eseguire l'elaborazione personalizzata, ad esempio l'inserimento di un corpo di entità diverso nella memoria.

Si applica a