HttpRequest.InsertEntityBody Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece um wrapper gerido para o método IIS que insere um corpo de entidade de pedido HTTP na memória.
Sobrecargas
| Name | Description |
|---|---|
| InsertEntityBody() |
Fornece ao IIS uma cópia do corpo da entidade de pedido HTTP. |
| InsertEntityBody(Byte[], Int32, Int32) |
Fornece ao IIS uma cópia do corpo da entidade de pedido HTTP e informações sobre o objeto da entidade de pedido. |
Observações
As InsertEntityBody sobrecargas do método proporcionam acesso gerido ao método IIS 7 IHttpRequest::InsertEntityBody . O método IIS insere um corpo de entidade de pedido HTTP (os dados que são publicados por um cliente) na memória. Isto é útil porque o IIS não mantém uma cópia da entidade do pedido depois de esta ter sido lida. Os InsertEntityBody métodos criam uma cópia dos dados da entidade de pedido HTTP e disponibilizam-na ao IIS para tratamento personalizado adicional.
Note
As InsertEntityBody sobrecargas de métodos funcionam apenas no IIS 7.0 ou posteriores, porque o IHttpRequest::InsertEntityBody método foi adicionado no IIS 7.0.
InsertEntityBody()
Fornece ao IIS uma cópia do corpo da entidade de pedido HTTP.
public:
void InsertEntityBody();public void InsertEntityBody();member this.InsertEntityBody : unit -> unitPublic Sub InsertEntityBody ()Exceções
O método foi invocado numa versão do IIS anterior ao IIS 7.0.
Observações
O IIS não mantém uma cópia do pedido depois de este ter sido lido. Por isso, recomenda-se que apenas o handler de um pedido HTTP leia a entidade do pedido.
A sobrecarga do método HttpRequest.InsertEntityBody fornece ao IIS uma cópia da entidade de pedido caso esta tenha sido lida anteriormente por ASP.NET. Esta sobrecarga de métodos é útil para casos em que o ASP.NET leu o pedido da entidade e pretende reutilizar os dados existentes do pedido.
Aplica-se a
InsertEntityBody(Byte[], Int32, Int32)
Fornece ao IIS uma cópia do corpo da entidade de pedido HTTP e informações sobre o objeto da entidade de pedido.
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[]
Um array que contém os dados da entidade de pedido.
- offset
- Int32
A posição base zero em buffer que se deve começar a armazenar os dados da entidade de pedido.
- count
- Int32
O número de bytes para ler no buffer array.
Exceções
O método foi invocado numa versão do IIS anterior ao IIS 7.0.
buffer é null.
offset ou count é um valor negativo.
O número de itens em count é maior do que o espaço disponível em buffer, dado o offset valor.
Observações
O IIS não mantém uma cópia do pedido depois de este ter sido lido. Por isso, recomenda-se que apenas o handler de um pedido HTTP leia a entidade do pedido.
A HttpRequest.InsertEntityBody sobrecarga de métodos é útil quando se pretende realizar processamento personalizado, como inserir um corpo de entidade diferente na memória.