HttpRequest.InsertEntityBody 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

提供 IIS 方法的 Managed 包裝函式，這個方法會將 HTTP 要求實體本文插入記憶體中。

多載

InsertEntityBody()	將 HTTP 要求實體本文的複本提供給 IIS。
InsertEntityBody(Byte[], Int32, Int32)	將 HTTP 要求實體本文的複本及該要求實體物件的相關資訊提供給 IIS。

備註

方法 InsertEntityBody 多載會提供 IIS 7 IHttpRequest::InsertEntityBody 方法的 Managed 存取權。 IIS 方法會將 HTTP 要求實體主體插入記憶體中 (用戶端所張貼的資料) 。 這非常有用，因為 IIS 不會在讀取要求實體之後維護其複本。 方法 InsertEntityBody 會建立 HTTP 要求實體資料的複本，並使它可供 IIS 用於其他自訂處理。

注意

方法 InsertEntityBody 多載僅適用于 IIS 7.0 或更新版本，因為已在 IHttpRequest::InsertEntityBody IIS 7.0 中新增 方法。

InsertEntityBody()

將 HTTP 要求實體本文的複本提供給 IIS。

public:
 void InsertEntityBody();

public void InsertEntityBody ();

member this.InsertEntityBody : unit -> unit

Public Sub InsertEntityBody ()

例外狀況

PlatformNotSupportedException

已在比 IIS 7.0 版舊的 IIS 上叫用此方法。

備註

IIS 在讀取要求之後，不會維護該要求的複本。 因此，建議只有 HTTP 要求的處理常式應該讀取要求實體。

如果先前由 ASP.NET 讀取要求實體，方法 HttpRequest.InsertEntityBody 多載會提供 IIS 的複本。 這個方法多載適用于 ASP.NET 已讀取實體要求，而且您想要重複使用現有要求資料的情況。

InsertEntityBody(Byte[], Int32, Int32)

將 HTTP 要求實體本文的複本及該要求實體物件的相關資訊提供給 IIS。

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

在指定 count 值的情況下，buffer 中的項目數大於 offset 的可用空間。

備註

在讀取要求之後，IIS 不會維護要求的複本。 因此，建議只有 HTTP 要求的處理常式應該讀取要求實體。

HttpRequest.InsertEntityBody當您想要執行自訂處理時，方法多載很有用，例如將不同的實體主體插入記憶體中。