HttpRequest.InsertEntityBody 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

为用于将 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 ()

例外

PlatformNotSupportedException

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

注解

读取请求后，IIS 不保留请求的副本。 因此，建议只有 HTTP 请求的处理程序才能读取请求实体。

方法 HttpRequest.InsertEntityBody 重载为 IIS 提供请求实体的副本（如果以前由 ASP.NET 读取）。 此方法重载适用于 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 数组中的字节数。

例外

PlatformNotSupportedException

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

ArgumentNullException

buffer 为 null。

ArgumentOutOfRangeException

offset 或 count 是负值。

ArgumentException

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

注解

读取请求后，IIS 不保留请求的副本。 因此，建议只有 HTTP 请求的处理程序才能读取请求实体。

若要执行自定义处理（例如将不同的实体主体插入内存中），方法 HttpRequest.InsertEntityBody 重载非常有用。