HttpRequest.InsertEntityBody Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic Sub InsertEntityBody ()Exceptions
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.
S’applique à
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 -> unitPublic 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
La méthode a été appelée sur une version d'IIS antérieure à IIS 7.0.
buffer a la valeur null.
offset ou count est une valeur négative.
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.