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 en mémoire.
Surcharges
| Nom | Description |
|---|---|
| InsertEntityBody() |
Fournit à IIS une copie du corps de l’entité de requête HTTP. |
| InsertEntityBody(Byte[], Int32, Int32) |
Fournit à IIS une copie du corps de l’entité de requête HTTP et des informations sur l’objet d’entité de 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 la rendent accessible à IIS pour une gestion personnalisée supplémentaire.
Note
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 de l’entité de 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 surcharge de méthode HttpRequest.InsertEntityBody 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 de l’entité de requête HTTP et des informations sur l’objet d’entité de 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 requête.
- offset
- Int32
Position de base zéro dans buffer laquelle commencer le stockage des données d’entité de requête.
- count
- Int32
Nombre d’octets à lire dans le buffer tableau.
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 lequel il est supérieur à l’espace bufferdisponible, compte tenu de la offset valeur.
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.