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 で使用できるようにします。

注意

メソッドのオーバーロードは InsertEntityBody IIS 7.0 以降でのみ機能します。これは、 メソッドが IIS 7.0 で追加されたためです IHttpRequest::InsertEntityBody 。

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 値を仮定すると、buffer の項目数が offset 内の使用可能な領域を超えています。

注釈

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

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