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.

Surcharges

InsertEntityBody()	Fournit à IIS une copie du corps d'entité de la requête HTTP.
InsertEntityBody(Byte[], Int32, Int32)	Fournit à 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.

Remarques

Les InsertEntityBody surcharges de méthode fournissent un accès managé à la méthode IIS 7 IHttpRequest::InsertEntityBody . 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. Cela est utile, car IIS ne conserve pas une copie de l’entité de requête une fois qu’elle a été lue. Les InsertEntityBody méthodes créent une copie des données d’entité de requête HTTP et les rendent accessibles à IIS pour une gestion personnalisée supplémentaire.

Notes

Les InsertEntityBody surcharges de méthode fonctionnent uniquement sur IIS 7.0 ou version ultérieure, car la IHttpRequest::InsertEntityBody méthode a été ajoutée dans IIS 7.0.

InsertEntityBody()

Fournit à IIS une copie du corps d'entité de la requête HTTP.

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.

Remarques

IIS ne conserve pas une copie de la demande une fois qu’elle a été lue. Par conséquent, il est recommandé que seul le gestionnaire d’une requête HTTP doit lire l’entité de requête.

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. Cette surcharge de méthode est utile pour les cas où ASP.NET a lu la demande d’entité et que vous souhaitez réutiliser les données de requête existantes.

InsertEntityBody(Byte[], Int32, Int32)

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

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.

offset

Int32

Position de base zéro dans buffer à laquelle commencer le stockage des données d'entité de la requête.

count

Int32

Nombre d'octets à lire dans le tableau buffer.

Exceptions

PlatformNotSupportedException

La méthode a été appelée sur une version d'IIS antérieure à IIS 7.0.

ArgumentNullException

buffer a la valeur null.

ArgumentOutOfRangeException

offset ou count est une valeur négative.

ArgumentException

Le nombre d'éléments dans count est supérieur à l'espace disponible dans buffer, étant donné la valeur de offset.

Remarques

IIS ne conserve pas une copie de la demande une fois qu’elle a été lue. Par conséquent, il est recommandé que seul le gestionnaire d’une requête HTTP doit lire l’entité de requête.

La HttpRequest.InsertEntityBody surcharge de méthode est utile lorsque vous souhaitez effectuer un traitement personnalisé, par exemple l’insertion d’un corps d’entité différent dans la mémoire.