HttpRequest.InsertEntityBody Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Fornece um wrapper gerenciado para o método IIS que insere um corpo de entidade de solicitação HTTP na memória.

Sobrecargas

InsertEntityBody()	Fornece ao IIS uma cópia do corpo da entidade de solicitação HTTP.
InsertEntityBody(Byte[], Int32, Int32)	Fornece ao IIS uma cópia do corpo da entidade da solicitação HTTP e informações sobre o objeto de entidade da solicitação.

Comentários

As InsertEntityBody sobrecargas do método fornecem acesso gerenciado ao método IIS 7 IHttpRequest::InsertEntityBody . O método IIS insere um corpo da entidade de solicitação HTTP (os dados que são postados por um cliente) na memória. Isso é útil porque o IIS não mantém uma cópia da entidade de solicitação após a leitura. Os InsertEntityBody métodos criam uma cópia dos dados da entidade de solicitação HTTP e os disponibilizam para o IIS para tratamento personalizado adicional.

Observação

As InsertEntityBody sobrecargas do método funcionam apenas no IIS 7.0 ou posterior, porque o IHttpRequest::InsertEntityBody método foi adicionado no IIS 7.0.

InsertEntityBody()

Fornece ao IIS uma cópia do corpo da entidade de solicitação HTTP.

public:
 void InsertEntityBody();

public void InsertEntityBody ();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

Exceções

PlatformNotSupportedException

O método foi invocado em uma versão do IIS anterior ao IIS 7.0.

Comentários

O IIS não mantém uma cópia da solicitação após a leitura. Portanto, é recomendável que apenas o manipulador de uma solicitação HTTP leia a entidade de solicitação.

A HttpRequest.InsertEntityBody sobrecarga do método fornece ao IIS uma cópia da entidade de solicitação se ela foi lida anteriormente por ASP.NET. Essa sobrecarga de método é útil para casos em que ASP.NET leu a solicitação de entidade e você deseja reutilizar os dados de solicitação existentes.

InsertEntityBody(Byte[], Int32, Int32)

Fornece ao IIS uma cópia do corpo da entidade da solicitação HTTP e informações sobre o objeto de entidade da solicitação.

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[]

Uma matriz que contém os dados de entidade da solicitação.

offset

Int32

A posição baseada em zero no buffer no qual começar a armazenar os dados de entidade da solicitação.

count

Int32

O número de bytes a ler na matriz do buffer.

Exceções

PlatformNotSupportedException

O método foi invocado em uma versão do IIS anterior ao IIS 7.0.

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

offset ou count é um valor negativo.

ArgumentException

O número de itens em count é maior do que o espaço disponível em buffer, devido ao valor de offset.

Comentários

O IIS não mantém uma cópia da solicitação após a leitura. Portanto, é recomendável que apenas o manipulador de uma solicitação HTTP leia a entidade de solicitação.

A HttpRequest.InsertEntityBody sobrecarga do método é útil quando você deseja executar o processamento personalizado, como inserir um corpo de entidade diferente na memória.