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 메서드 오버로드는 이전에 ASP.NET 읽은 경우 요청 엔터티의 복사본을 IIS에 제공합니다. 이 메서드 오버로드는 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의 위치(0부터 시작)입니다.

count

Int32

buffer 배열로 읽어 들일 바이트 수입니다.

예외

PlatformNotSupportedException

IIS 7.0 이전 버전의 IIS에서 메서드가 호출되었습니다.

ArgumentNullException

buffer이(가) null인 경우

ArgumentOutOfRangeException

offset 또는 count는 음수 값입니다.

ArgumentException

count의 항목 수는 값이 buffer인 offset의 사용 가능한 공간보다 큽니다.

설명

IIS는 읽은 후 요청의 복사본을 유지 관리하지 않습니다. 따라서 HTTP 요청의 처리기만 요청 엔터티를 읽는 것이 좋습니다.

HttpRequest.InsertEntityBody 메서드 오버로드는 메모리에 다른 엔터티 본문을 삽입하는 등 사용자 지정 처리를 수행하려는 경우에 유용합니다.