HttpRequest.InsertEntityBody メソッド

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

HTTP 要求エンティティ本体をメモリに挿入する IIS メソッドのマネージド ラッパーを提供します。

オーバーロード

名前 説明
InsertEntityBody()

HTTP 要求エンティティ本文のコピーを IIS に提供します。
InsertEntityBody(Byte[], Int32, Int32)

HTTP 要求エンティティ本文のコピーと、要求エンティティ オブジェクトに関する情報を IIS に提供します。

注釈

InsertEntityBody メソッドのオーバーロードは、IIS 7 IHttpRequest::InsertEntityBody メソッドへのマネージド アクセスを提供します。 IIS メソッドは、HTTP 要求エンティティ本文 (クライアントによってポストされるデータ) をメモリに挿入します。 これは、IIS が読み取られた後に要求エンティティのコピーを保持しないために役立ちます。 InsertEntityBodyメソッドは、HTTP 要求エンティティ データのコピーを作成し、追加のカスタム処理のために IIS で使用できるようにします。

Note

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 要求のハンドラーのみが要求エンティティを読み取る必要があります。

HttpRequest.InsertEntityBody メソッドオーバーロードは、要求エンティティが以前に ASP.NET によって読み取られた場合に、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 の 0 から始まる位置。

count
Int32

buffer配列に読み込むバイト数。

例外

PlatformNotSupportedException

このメソッドは、IIS 7.0 より前のバージョンの IIS で呼び出されました。

ArgumentNullException

buffer は nullです。

ArgumentOutOfRangeException

offset または count が負の値です。

ArgumentException

count内の項目の数は、offset値を指定すると、buffer内の使用可能な領域よりも大きくなります。

注釈

IIS は、読み取られた後も要求のコピーを保持しません。 そのため、HTTP 要求のハンドラーのみが要求エンティティを読み取る必要があります。

HttpRequest.InsertEntityBody メソッドのオーバーロードは、別のエンティティ本体をメモリに挿入するなど、カスタム処理を実行する場合に便利です。

適用対象