HttpRequest.InsertEntityBody Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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

PlatformNotSupportedException

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.

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

PlatformNotSupportedException

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

ArgumentNullException

buffer è null.

ArgumentOutOfRangeException

offset o count è un valore negativo.

ArgumentException

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.