HttpRequest.InsertEntityBody Metodo

Definizione

Fornisce un wrapper gestito per il metodo IIS che inserisce un corpo di entità di richiesta HTTP in memoria.Provides a managed wrapper for the IIS method that inserts an HTTP request entity body into memory.

Overload

InsertEntityBody()

Fornisce a IIS una copia del corpo di entità di richiesta HTTP.Provides IIS with a copy of the HTTP request entity body.

InsertEntityBody(Byte[], Int32, Int32)

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP nonché le informazioni sull'oggetto entità di richiesta.Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

Commenti

Gli InsertEntityBody overload del metodo forniscono l'accesso gestito al metodo di IIS IHttpRequest::InsertEntityBody 7.The InsertEntityBody method overloads provide managed access to the IIS 7 IHttpRequest::InsertEntityBody method. Il metodo IIS inserisce in memoria un corpo dell'entità di richiesta HTTP (i dati inviati da un client).The IIS method inserts an HTTP request entity body (the data that is posted by a client) into memory. Questa operazione è utile perché IIS non mantiene una copia dell'entità Request dopo che è stata letta.This is useful because IIS does not maintain a copy of the request entity after it has been read. I InsertEntityBody metodi creano una copia dei dati dell'entità di richiesta HTTP e li rendono disponibili in IIS per una gestione aggiuntiva personalizzata.The InsertEntityBody methods create a copy of the HTTP request entity data and make it available to IIS for additional custom handling.

Nota

Gli InsertEntityBody overload del metodo funzionano solo in IIS 7,0 o versioni successive, perché il IHttpRequest::InsertEntityBody metodo è stato aggiunto in IIS 7,0.The InsertEntityBody method overloads work only on IIS 7.0 or later, because the IHttpRequest::InsertEntityBody method was added in IIS 7.0.

InsertEntityBody()

Fornisce a IIS una copia del corpo di entità di richiesta HTTP.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 ()

Eccezioni

Il metodo è stato richiamato su una versione di IIS precedente a IIS 7.0.The method was invoked on a version of IIS earlier than IIS 7.0.

Commenti

IIS non mantiene una copia della richiesta dopo che è stata letta.IIS does not maintain a copy of the request after it has been read. Pertanto, è consigliabile che solo il gestore per una richiesta HTTP legga l'entità request.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

L' HttpRequest.InsertEntityBody overload del metodo fornisce a IIS una copia dell'entità request se è stata precedentemente letta da ASP.NET.The HttpRequest.InsertEntityBody method overload provides IIS with a copy of the request entity if it was previously read by ASP.NET. Questo overload del metodo è utile nei casi in cui ASP.NET ha letto la richiesta di entità e si desidera riutilizzare i dati della richiesta esistente.This method overload is useful for cases where ASP.NET has read the entity request and you want to reuse the existing request data.

Sicurezza

AspNetHostingPermission
Per il funzionamento in un ambiente host.For operating in a hosted environment. Azione di sicurezza Demand:.Security action: Demand. Enumerazione associata:HighAssociated enumeration: High

InsertEntityBody(Byte[], Int32, Int32)

Fornisce a IIS una copia del corpo dell'entità di richiesta HTTP nonché le informazioni sull'oggetto entità di richiesta.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)

Parametri

buffer
Byte[]

Matrice contenente i dati dell'entità di richiesta.An array that contains the request entity data.

offset
Int32

Posizione in base zero in buffer in corrispondenza della quale iniziare ad archiviare i dati dell'entità di richiesta.The zero-based position in buffer at which to begin storing the request entity data.

count
Int32

Numero di byte da leggere e archiviare nella matrice buffer.The number of bytes to read into the buffer array.

Eccezioni

Il metodo è stato richiamato su una versione di IIS precedente a IIS 7.0.The method was invoked on a version of IIS earlier than IIS 7.0.

buffer è null.buffer is null.

offset o count è un valore negativo.offset or count is a negative value.

Il numero di elementi nell'oggetto count è maggiore dello spazio disponibile in buffer, dato il valore di offset.The number of items in count is larger than the available space in buffer, given the offset value.

Commenti

IIS non mantiene una copia della richiesta dopo che è stata letta.IIS does not maintain a copy of the request after it has been read. Pertanto, è consigliabile che solo il gestore per una richiesta HTTP legga l'entità request.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

L' HttpRequest.InsertEntityBody overload del metodo è utile quando si desidera eseguire un'elaborazione personalizzata, ad esempio l'inserimento di un corpo di entità diverso in memoria.The HttpRequest.InsertEntityBody method overload is useful when you want to perform custom processing, such as inserting a different entity body into memory.

Sicurezza

AspNetHostingPermission
per il funzionamento in un ambiente host.for operating in a hosted environment. Azione di sicurezza Demand:.Security action: Demand. Enumerazione associata:HighAssociated enumeration: High

Si applica a