HttpRequest.InsertEntityBody 方法

定義

命名空間:
System.Web
組件:
System.Web.dll

提供一個受管理包裝器，用於將 HTTP 請求實體實體插入記憶體。

多載

名稱 Description
InsertEntityBody()

提供 IIS HTTP 請求實體實體的副本。
InsertEntityBody(Byte[], Int32, Int32)

提供 IIS HTTP 請求實體實體的副本及請求實體物件的資訊。

備註

InsertEntityBody方法過載提供對 IIS 7 IHttpRequest::InsertEntityBody 方法的管理存取。 IIS 方法將 HTTP 請求實體實體體（用戶端所發布的資料）插入記憶體中。 這很有用，因為 IIS 在讀取請求實體後不會保留副本。 這些 InsertEntityBody 方法會產生 HTTP 請求實體資料的副本，並提供給 IIS 以供額外自訂處理。

Note

此 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 在申請已讀後不會保留副本。 因此，建議只有 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 之前的版本中被調用。

ArgumentNullException

buffer 是 null。

ArgumentOutOfRangeException

offset 或 count 為負值。

ArgumentException

在 中count項目的數量大於給定buffer值的offset可用空間。

備註

IIS 在申請已讀後不會保留副本。 因此，建議只有 HTTP 請求的處理器才能讀取請求實體。

HttpRequest.InsertEntityBody方法過載在你想執行自訂處理時非常有用，例如將不同的實體實體插入記憶體。

適用於