HttpRequest.InsertEntityBody Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un contenedor administrado para el método de IIS que inserta el cuerpo de una entidad de solicitud HTTP en la memoria.
Sobrecargas
| InsertEntityBody() |
Proporciona a IIS una copia del cuerpo de la entidad de solicitud HTTP. |
| InsertEntityBody(Byte[], Int32, Int32) |
Proporciona a IIS una copia del cuerpo de la entidad de solicitud HTTP e información sobre el objeto entidad de solicitud. |
Comentarios
Las sobrecargas del InsertEntityBody método proporcionan acceso administrado al método IIS 7 IHttpRequest::InsertEntityBody . El método IIS inserta un cuerpo de entidad de solicitud HTTP (los datos publicados por un cliente) en la memoria. Esto resulta útil porque IIS no mantiene una copia de la entidad de solicitud después de leerla. Los InsertEntityBody métodos crean una copia de los datos de entidad de solicitud HTTP y hacen que estén disponibles para IIS para un control personalizado adicional.
Nota
Las InsertEntityBody sobrecargas del método solo funcionan en IIS 7.0 o posterior, porque el IHttpRequest::InsertEntityBody método se agregó en IIS 7.0.
InsertEntityBody()
Proporciona a IIS una copia del cuerpo de la entidad de solicitud HTTP.
public:
void InsertEntityBody();public void InsertEntityBody ();member this.InsertEntityBody : unit -> unitPublic Sub InsertEntityBody ()Excepciones
El método se invocó en una versión de IIS anterior a IIS 7.0.
Comentarios
IIS no mantiene una copia de la solicitud después de leerla. Por lo tanto, se recomienda que solo el controlador de una solicitud HTTP lea la entidad de solicitud.
La HttpRequest.InsertEntityBody sobrecarga del método proporciona a IIS una copia de la entidad de solicitud si la leyó anteriormente ASP.NET. Esta sobrecarga de método es útil en los casos en los que ASP.NET ha leído la solicitud de entidad y desea reutilizar los datos de solicitud existentes.
Se aplica a
InsertEntityBody(Byte[], Int32, Int32)
Proporciona a IIS una copia del cuerpo de la entidad de solicitud HTTP e información sobre el objeto entidad de solicitud.
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)Parámetros
- buffer
- Byte[]
Matriz que contiene los datos de la entidad de solicitud.
- offset
- Int32
Posición de base cero en buffer donde se comienzan a almacenar los datos de la entidad de solicitud.
- count
- Int32
Número de bytes que se van a leer en la matriz buffer.
Excepciones
El método se invocó en una versión de IIS anterior a IIS 7.0.
buffer es null.
El valor de offset o count es negativo.
El número de elementos de count es mayor que el espacio disponible en buffer, especificado el valor offset.
Comentarios
IIS no mantiene una copia de la solicitud después de leerla. Por lo tanto, se recomienda que solo el controlador de una solicitud HTTP lea la entidad de solicitud.
La HttpRequest.InsertEntityBody sobrecarga del método es útil cuando se desea realizar un procesamiento personalizado, como insertar un cuerpo de entidad diferente en la memoria.
