HttpRequest.InsertEntityBody 方法

定义

为用于将 HTTP 请求实体正文插入内存的 IIS 方法提供托管包装。

重载

InsertEntityBody()

向 IIS 提供 HTTP 请求实体正文的副本。

InsertEntityBody(Byte[], Int32, Int32)

向 IIS 提供 HTTP 请求实体正文的副本以及有关请求实体对象的信息。

注解

方法 InsertEntityBody 重载提供对 IIS 7 IHttpRequest::InsertEntityBody 方法的托管访问。 IIS 方法将 HTTP 请求实体正文 (客户端) 发布到内存中的数据。 这很有用,因为 IIS 在读取请求实体后不会保留请求实体的副本。 这些 InsertEntityBody 方法创建 HTTP 请求实体数据的副本,并使它可供 IIS 用于其他自定义处理。

备注

方法 InsertEntityBody 重载仅适用于 IIS 7.0 或更高版本,因为该方法 IHttpRequest::InsertEntityBody 已在 IIS 7.0 中添加。

InsertEntityBody()

向 IIS 提供 HTTP 请求实体正文的副本。

public:
 void InsertEntityBody();
public void InsertEntityBody ();
member this.InsertEntityBody : unit -> unit
Public Sub InsertEntityBody ()

例外

在 IIS 7.0 以前的 IIS 版本上调用该方法。

注解

IIS 在读取请求后不会保留请求的副本。 因此,建议只有 HTTP 请求的处理程序应读取请求实体。

如果以前通过 ASP.NET 读取请求实体,该方法HttpRequest.InsertEntityBody重载会为 IIS 提供请求实体的副本。 此方法重载对于 ASP.NET 已读取实体请求且想要重复使用现有请求数据的情况非常有用。

适用于

InsertEntityBody(Byte[], Int32, Int32)

向 IIS 提供 HTTP 请求实体正文的副本以及有关请求实体对象的信息。

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)

参数

buffer
Byte[]

一个包含请求实体数据的数组。

offset
Int32

buffer 中开始存储请求实体数据的位置,该位置从零开始计数。

count
Int32

要读取到 buffer 数组中的字节数。

例外

在 IIS 7.0 以前的 IIS 版本上调用该方法。

buffernull

offsetcount 是负值。

如果给定 offset 值,则 count 中的项目数大于 buffer 中的可用空间。

注解

IIS 在读取请求后不会保留请求的副本。 因此,建议只有 HTTP 请求的处理程序应读取请求实体。

如果要执行自定义处理,例如将其他实体体插入内存中,此方法 HttpRequest.InsertEntityBody 重载非常有用。

适用于