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à 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 -> 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 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 -> unitPublic 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.
