HttpRequest.InsertEntityBody Méthode

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Fournit un wrapper managé pour la méthode IIS qui insère un corps d'entité de requête HTTP dans la mémoire.Provides a managed wrapper for the IIS method that inserts an HTTP request entity body into memory.

Surcharges

InsertEntityBody()

Fournit aux services Internet (IIS) une copie du corps d'entité de la requête HTTP.Provides IIS with a copy of the HTTP request entity body.
InsertEntityBody(Byte[], Int32, Int32)

Fournit aux services Internet (IIS) une copie du corps d'entité de la requête HTTP et des informations à propos de l'objet d'entité de la requête.Provides IIS with a copy of the HTTP request entity body and with information about the request entity object.

Remarques

Les InsertEntityBody surcharges de méthode fournissent un accès managé à la IHttpRequest::InsertEntityBody méthode IIS 7.The InsertEntityBody method overloads provide managed access to the IIS 7 IHttpRequest::InsertEntityBody method. La méthode IIS insère un corps d’entité de requête HTTP (les données publiées par un client) en mémoire.The IIS method inserts an HTTP request entity body (the data that is posted by a client) into memory. Cela est utile, car IIS ne conserve pas une copie de l’entité de la demande après qu’elle a été lue.This is useful because IIS does not maintain a copy of the request entity after it has been read. Les InsertEntityBody méthodes créent une copie des données d’entité de la requête HTTP et la mettent à la disposition d’IIS pour une gestion personnalisée supplémentaire.The InsertEntityBody methods create a copy of the HTTP request entity data and make it available to IIS for additional custom handling.

Notes

Les InsertEntityBody surcharges de méthode fonctionnent uniquement sur IIS 7,0 ou version ultérieure, IHttpRequest::InsertEntityBody car la méthode a été ajoutée dans 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()

Fournit aux services Internet (IIS) une copie du corps d'entité de la requête 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 ()

Exceptions

PlatformNotSupportedException

La méthode a été appelée sur une version d’IIS antérieure à IIS 7.0.The method was invoked on a version of IIS earlier than IIS 7.0.

Remarques

IIS ne conserve pas une copie de la demande après qu’elle a été lue.IIS does not maintain a copy of the request after it has been read. Par conséquent, il est recommandé que seul le gestionnaire d’une requête HTTP lise l’entité de requête.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

La HttpRequest.InsertEntityBody surcharge de méthode fournit à IIS une copie de l’entité de requête si elle a été précédemment lue par ASP.net.The HttpRequest.InsertEntityBody method overload provides IIS with a copy of the request entity if it was previously read by ASP.NET. Cette surcharge de méthode est utile dans les cas où ASP.NET a lu la demande d’entité et que vous souhaitez réutiliser les données de la requête existante.This method overload is useful for cases where ASP.NET has read the entity request and you want to reuse the existing request data.

Sécurité

AspNetHostingPermission
pour le fonctionnement dans un environnement hébergé.For operating in a hosted environment. Action de sécurité Demand:.Security action: Demand. Énumération associée:HighAssociated enumeration: High

InsertEntityBody(Byte[], Int32, Int32)

Fournit aux services Internet (IIS) une copie du corps d'entité de la requête HTTP et des informations à propos de l'objet d'entité de la requête.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)

Paramètres

buffer
Byte[]

Tableau qui contient les données d'entité de la requête.An array that contains the request entity data.

offset
Int32

Position de base zéro dans buffer à laquelle commencer le stockage des données d'entité de la requête.The zero-based position in buffer at which to begin storing the request entity data.

count
Int32

Nombre d'octets à lire dans le tableau buffer.The number of bytes to read into the buffer array.

Exceptions

PlatformNotSupportedException

La méthode a été appelée sur une version d’IIS antérieure à IIS 7.0.The method was invoked on a version of IIS earlier than IIS 7.0.

ArgumentNullException

buffer est null.buffer is null.

ArgumentOutOfRangeException

offset ou count est une valeur négative.offset or count is a negative value.

ArgumentException

Le nombre d'éléments dans count est supérieur à l'espace disponible dans buffer, étant donné la valeur de offset.The number of items in count is larger than the available space in buffer, given the offset value.

Remarques

IIS ne conserve pas une copie de la demande après qu’elle a été lue.IIS does not maintain a copy of the request after it has been read. Par conséquent, il est recommandé que seul le gestionnaire d’une requête HTTP lise l’entité de requête.Therefore, it is recommended that only the handler for an HTTP request should read the request entity.

La HttpRequest.InsertEntityBody surcharge de méthode est utile lorsque vous souhaitez effectuer un traitement personnalisé, tel que l’insertion d’un corps d’entité différent dans la mémoire.The HttpRequest.InsertEntityBody method overload is useful when you want to perform custom processing, such as inserting a different entity body into memory.

Sécurité

AspNetHostingPermission
pour fonctionner dans un environnement hébergé.for operating in a hosted environment. Action de sécurité Demand:.Security action: Demand. Énumération associée:HighAssociated enumeration: High

S’applique à