HttpRequest.InsertEntityBody Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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 -> unit

Public Sub InsertEntityBody ()

Excepciones

PlatformNotSupportedException

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.

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 -> unit

Public 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

PlatformNotSupportedException

El método se invocó en una versión de IIS anterior a IIS 7.0.

ArgumentNullException

buffer es null.

ArgumentOutOfRangeException

El valor de offset o count es negativo.

ArgumentException

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.