HttpRequest.InsertEntityBody Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece um wrapper gerenciado para o método IIS que insere um corpo de entidade de solicitação HTTP na memória.
Sobrecargas
| Nome | Description |
|---|---|
| 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 de solicitação HTTP e informações sobre o objeto de entidade de 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 de 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 depois que ela é lida. 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.
Note
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 -> unitPublic Sub InsertEntityBody ()Exceções
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 depois que ela é lida. Portanto, é recomendável que somente o manipulador de uma solicitação HTTP leia a entidade de solicitação.
A sobrecarga do método HttpRequest.InsertEntityBody 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.
Aplica-se a
InsertEntityBody(Byte[], Int32, Int32)
Fornece ao IIS uma cópia do corpo da entidade de solicitação HTTP e informações sobre o objeto de entidade de 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 -> unitPublic Sub InsertEntityBody (buffer As Byte(), offset As Integer, count As Integer)Parâmetros
- buffer
- Byte[]
Uma matriz que contém os dados da entidade de solicitação.
- offset
- Int32
A posição baseada em zero na buffer qual começar a armazenar os dados da entidade de solicitação.
- count
- Int32
O número de bytes a serem lidos na buffer matriz.
Exceções
O método foi invocado em uma versão do IIS anterior ao IIS 7.0.
buffer é null.
offset ou count é um valor negativo.
O número de itens dentro count é maior do que o espaço disponível, bufferdado o offset valor.
Comentários
O IIS não mantém uma cópia da solicitação depois que ela é lida. Portanto, é recomendável que somente 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.