HttpRequest.InsertEntityBody Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un wrapper gestito per il metodo IIS che inserisce un corpo dell'entità richiesta HTTP in memoria.
Overload
| Nome | Descrizione |
|---|---|
| InsertEntityBody() |
Fornisce IIS con una copia del corpo dell'entità richiesta HTTP. |
| InsertEntityBody(Byte[], Int32, Int32) |
Fornisce IIS con una copia del corpo dell'entità richiesta HTTP e con informazioni sull'oggetto entità richiesta. |
Commenti
Gli overload del InsertEntityBody metodo forniscono l'accesso gestito al metodo IIS 7 IHttpRequest::InsertEntityBody . Il metodo IIS inserisce in memoria un corpo dell'entità richiesta HTTP (i dati inseriti da un client). Ciò è 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.
Note
Gli overload del InsertEntityBody metodo funzionano solo in IIS 7.0 o versione successiva, perché il IHttpRequest::InsertEntityBody metodo è stato aggiunto in IIS 7.0.
InsertEntityBody()
Fornisce IIS con una copia del corpo dell'entità richiesta HTTP.
public:
void InsertEntityBody();public void InsertEntityBody();member this.InsertEntityBody : unit -> unitPublic 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 del metodo HttpRequest.InsertEntityBody fornisce a IIS una copia dell'entità richiesta se è stata letta in precedenza da ASP.NET. Questo overload del metodo è utile per i casi in cui ASP.NET ha letto la richiesta di entità e si desidera riutilizzare i dati delle richieste esistenti.
Si applica a
InsertEntityBody(Byte[], Int32, Int32)
Fornisce IIS con una copia del corpo dell'entità richiesta HTTP e con informazioni sull'oggetto entità 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 -> unitPublic Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)Parametri
- buffer
- Byte[]
Matrice che contiene i dati dell'entità richiesta.
- offset
- Int32
Posizione in base zero in in buffer corrispondenza della quale iniziare a archiviare i dati dell'entità richiesta.
- count
- Int32
Numero di byte da leggere nella buffer matrice.
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 in count è maggiore dello spazio disponibile in buffer, dato il offset valore .
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 desidera eseguire l'elaborazione personalizzata, ad esempio l'inserimento di un corpo di entità diverso in memoria.